/* passed *  linux/fs/open.c * *  (C) 1991  Linus Torvalds */#include <set_seg.h>
#include <string.h>// 字符串頭文件。主要定義了一些有關字符串操作的嵌入函數。#include <errno.h>// 錯誤號頭文件。包含系統中各種出錯號。(Linus 從minix 中引進的)。#include <fcntl.h>// 文件控制頭文件。用于文件及其描述符的操作控制常數符號的定義。#include <sys/types.h>// 類型頭文件。定義了基本的系統數據類型。#include <utime.h>// 用戶時間頭文件。定義了訪問和修改時間結構以及utime()原型。#include <sys/stat.h>// 文件狀態頭文件。含有文件或文件系統狀態結構stat{}和常量。#include <linux/sched.h>// 調度程序頭文件，定義了任務結構task_struct、初始任務0 的數據，
						// 還有一些有關描述符參數設置和獲取的嵌入式匯編函數宏語句。#include <linux/tty.h>// tty 頭文件，定義了有關tty_io，串行通信方面的參數、常數。#include <linux/kernel.h>// 內核頭文件。含有一些內核常用函數的原形定義。#include <asm/segment.h>// 段操作頭文件。定義了有關段寄存器操作的嵌入式匯編函數。
// 取文件系統信息系統調用函數。int sys_ustat(int dev, struct ustat * ubuf){	return -ENOSYS;}
//// 設置文件訪問和修改時間。
// 參數filename 是文件名，times 是訪問和修改時間結構指針。
// 如果times 指針不為NULL，則取utimbuf 結構中的時間信息來設置文件的訪問和修改時間。如果
// times 指針是NULL，則取系統當前時間來設置指定文件的訪問和修改時間域。int sys_utime(char * filename, struct utimbuf * times){	struct m_inode * inode;	long actime,modtime;
// 根據文件名尋找對應的i 節點，如果沒有找到，則返回出錯碼。	if (!(inode=namei(filename)))		return -ENOENT;
// 如果訪問和修改時間數據結構指針不為NULL，則從結構中讀取用戶設置的時間值。	if (times) {		actime = get_fs_long((unsigned long *) &times->actime);		modtime = get_fs_long((unsigned long *) &times->modtime);
// 否則將訪問和修改時間置為當前時間。	} else		actime = modtime = CURRENT_TIME;
// 修改i 節點中的訪問時間字段和修改時間字段。	inode->i_atime = actime;	inode->i_mtime = modtime;
// 置i 節點已修改標志，釋放該節點，并返回0。	inode->i_dirt = 1;	iput(inode);	return 0;}/* * 文件屬性XXX，我們該用真實用戶id 還是有效用戶id？BSD 系統使用了真實用戶id，
 * 以使該調用可以供setuid 程序使用。（注：POSIX 標準建議使用真實用戶ID） */
//// 檢查對文件的訪問權限。
// 參數filename 是文件名，mode 是屏蔽碼，由R_OK(4)、W_OK(2)、X_OK(1)和F_OK(0)組成。
// 如果請求訪問允許的話，則返回0，否則返回出錯碼。int sys_access(const char * filename,int mode){	struct m_inode * inode;	int res, i_mode;
// 屏蔽碼由低3 位組成，因此清除所有高比特位。	mode &= 0007;
// 如果文件名對應的i 節點不存在，則返回出錯碼。	if (!(inode=namei(filename)))		return -EACCES;
// 取文件的屬性碼，并釋放該i 節點。	i_mode = res = inode->i_mode & 0777;	iput(inode);
// 如果當前進程是該文件的宿主，則取文件宿主屬性。	if (current->uid == inode->i_uid)		res >>= 6;
// 否則如果當前進程是與該文件同屬一組，則取文件組屬性。	else if (current->gid == inode->i_gid)		res >>= 6;
// 如果文件屬性具有查詢的屬性位，則訪問許可，返回0。	if ((res & 0007 & mode) == mode)		return 0;/* * XXX 我們最后才做下面的測試，因為我們實際上需要交換有效用戶id 和
 * 真實用戶id（臨時地），然后才調用suser()函數。如果我們確實要調用
 * suser()函數，則需要最后才被調用。  */
// 如果當前用戶id 為0（超級用戶）并且屏蔽碼執行位是0 或文件可以被任何人訪問，則返回0。	if ((!current->uid) &&	    (!(mode & 1) || (i_mode & 0111)))		return 0;
	// 否則返回出錯碼。	return -EACCES;}
//// 改變當前工作目錄系統調用函數。
// 參數filename 是目錄名。
// 操作成功則返回0，否則返回出錯碼。int sys_chdir(const char * filename){	struct m_inode * inode;
// 如果文件名對應的i 節點不存在，則返回出錯碼。	if (!(inode = namei(filename)))		return -ENOENT;
// 如果該i 節點不是目錄的i 節點，則釋放該節點，返回出錯碼。	if (!S_ISDIR(inode->i_mode)) {		iput(inode);		return -ENOTDIR;	}
// 釋放當前進程原工作目錄i 節點，并指向該新置的工作目錄i 節點。返回0。	iput(current->pwd);	current->pwd = inode;	return (0);}
//// 改變根目錄系統調用函數。
// 將指定的路徑名改為根目錄'/'。
// 如果操作成功則返回0，否則返回出錯碼。int sys_chroot(const char * filename){	struct m_inode * inode;
// 如果文件名對應的i 節點不存在，則返回出錯碼。	if (!(inode=namei(filename)))		return -ENOENT;
// 如果該i 節點不是目錄的i 節點，則釋放該節點，返回出錯碼。	if (!S_ISDIR(inode->i_mode)) {		iput(inode);		return -ENOTDIR;	}
// 釋放當前進程的根目錄i 節點，并重置為這里指定目錄名的i 節點，返回0。	iput(current->root);	current->root = inode;	return (0);}
//// 修改文件屬性系統調用函數。
// 參數filename 是文件名，mode 是新的文件屬性。
// 若操作成功則返回0，否則返回出錯碼。int sys_chmod(const char * filename,int mode){	struct m_inode * inode;
// 如果文件名對應的i 節點不存在，則返回出錯碼。
	if (!(inode=namei(filename)))		return -ENOENT;
// 如果當前進程的有效用戶id 不等于文件i 節點的用戶id，并且當前進程不是超級用戶，則釋放該
// 文件i 節點，返回出錯碼。	if ((current->euid != inode->i_uid) && !suser()) {		iput(inode);		return -EACCES;	}
// 重新設置i 節點的文件屬性，并置該i 節點已修改標志。釋放該i 節點，返回0。	inode->i_mode = (mode & 07777) | (inode->i_mode & ~07777);	inode->i_dirt = 1;	iput(inode);	return 0;}
//// 修改文件宿主系統調用函數。
// 參數filename 是文件名，uid 是用戶標識符(用戶id)，gid 是組id。
// 若操作成功則返回0，否則返回出錯碼。int sys_chown(const char * filename,int uid,int gid){	struct m_inode * inode;
// 如果文件名對應的i 節點不存在，則返回出錯碼。	if (!(inode=namei(filename)))		return -ENOENT;
// 若當前進程不是超級用戶，則釋放該i 節點，返回出錯碼。	if (!suser()) {		iput(inode);		return -EACCES;	}
// 設置文件對應i 節點的用戶id 和組id，并置i 節點已經修改標志，釋放該i 節點，返回0。	inode->i_uid=uid;	inode->i_gid=gid;	inode->i_dirt=1;	iput(inode);	return 0;}
//// 打開（或創建）文件系統調用函數。
// 參數filename 是文件名，flag 是打開文件標志：只讀O_RDONLY、只寫O_WRONLY 或讀寫O_RDWR，
// 以及O_CREAT、O_EXCL、O_APPEND 等其它一些標志的組合，若本函數創建了一個新文件，則mode
// 用于指定使用文件的許可屬性，這些屬性有S_IRWXU(文件宿主具有讀、寫和執行權限)、S_IRUSR
// (用戶具有讀文件權限)、S_IRWXG(組成員具有讀、寫和執行權限)等等。對于新創建的文件，這些
// 屬性只應用于將來對文件的訪問，創建了只讀文件的打開調用也將返回一個可讀寫的文件句柄。
// 若操作成功則返回文件句柄(文件描述符)，否則返回出錯碼。(參見sys/stat.h, fcntl.h)int sys_open(const char * filename,int flag,int mode){	struct m_inode * inode;	struct file * f;	int i,fd;
// 將用戶設置的模式與進程的模式屏蔽碼相與，產生許可的文件模式。	mode &= 0777 & ~current->umask;
// 搜索進程結構中文件結構指針數組，查找一個空閑項，若已經沒有空閑項，則返回出錯碼。	for(fd=0 ; fd<NR_OPEN ; fd++)		if (!current->filp[fd])			break;	if (fd>=NR_OPEN)		return -EINVAL;
// 設置執行時關閉文件句柄位圖，復位對應比特位。	current->close_on_exec &= ~(1<<fd);
// 令f 指向文件表數組開始處。搜索空閑文件結構項(句柄引用計數為0 的項)，若已經沒有空閑
// 文件表結構項，則返回出錯碼。	f=0+file_table;	for (i=0 ; i<NR_FILE ; i++,f++)		if (!f->f_count) break;	if (i>=NR_FILE)		return -EINVAL;
// 讓進程的對應文件句柄的文件結構指針指向搜索到的文件結構，并令句柄引用計數遞增1。	(current->filp[fd]=f)->f_count++;
// 調用函數執行打開操作，若返回值小于0，則說明出錯，釋放剛申請到的文件結構，返回出錯碼。	if ((i=open_namei(filename,flag,mode,&inode))<0) {		current->filp[fd]=NULL;		f->f_count=0;		return i;	}/* ttys 有些特殊（ttyxx 主號==4，tty 主號==5）*/
// 如果是字符設備文件，那么如果設備號是4 的話，則設置當前進程的tty 號為該i 節點的子設備號。
// 并設置當前進程tty 對應的tty 表項的父進程組號等于進程的父進程組號。	if (S_ISCHR(inode->i_mode))		if (MAJOR(inode->i_zone[0])==4) {			if (current->leader && current->tty<0) {				current->tty = MINOR(inode->i_zone[0]);				tty_table[current->tty].pgrp = current->pgrp;			}
// 否則如果該字符文件設備號是5 的話，若當前進程沒有tty，則說明出錯，釋放i 節點和申請到的
// 文件結構，返回出錯碼。		} else if (MAJOR(inode->i_zone[0])==5)			if (current->tty<0) {				iput(inode);				current->filp[fd]=NULL;				f->f_count=0;				return -EPERM;			}/* 同樣對于塊設備文件：需要檢查盤片是否被更換 */
// 如果打開的是塊設備文件，則檢查盤片是否更換，若更換則需要是高速緩沖中對應該設備的所有
// 緩沖塊失效。	if (S_ISBLK(inode->i_mode))		check_disk_change(inode->i_zone[0]);
// 初始化文件結構。置文件結構屬性和標志，置句柄引用計數為1，設置i 節點字段，文件讀寫指針
// 初始化為0。返回文件句柄。	f->f_mode = inode->i_mode;	f->f_flags = flag;	f->f_count = 1;	f->f_inode = inode;	f->f_pos = 0;	return (fd);}
//// 創建文件系統調用函數。
// 參數pathname 是路徑名，mode 與上面的sys_open()函數相同。
// 成功則返回文件句柄，否則返回出錯碼。int sys_creat(const char * pathname, int mode){	return sys_open(pathname, O_CREAT | O_TRUNC, mode);}
// 關閉文件系統調用函數。
// 參數fd 是文件句柄。
// 成功則返回0，否則返回出錯碼。int sys_close(unsigned int fd){		struct file * filp;
// 若文件句柄值大于程序同時能打開的文件數，則返回出錯碼。	if (fd >= NR_OPEN)		return -EINVAL;
// 復位進程的執行時關閉文件句柄位圖對應位。	current->close_on_exec &= ~(1<<fd);
// 若該文件句柄對應的文件結構指針是NULL，則返回出錯碼。	if (!(filp = current->filp[fd]))		return -EINVAL;
// 置該文件句柄的文件結構指針為NULL。	current->filp[fd] = NULL;
// 若在關閉文件之前，對應文件結構中的句柄引用計數已經為0，則說明內核出錯，死機。	if (filp->f_count == 0)		panic("Close: file count is 0");
// 否則將對應文件結構的句柄引用計數減1，如果還不為0，則返回0（成功）。若已等于0，說明該
// 文件已經沒有句柄引用，則釋放該文件i 節點，返回0。	if (--filp->f_count)		return (0);	iput(filp->f_inode);	return (0);}