/** linux/fs/open.c** (C) 1991 Linus Torvalds*/#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>	// 段操作頭文件。定義了有關段寄存器操作的嵌入式匯編函數。// 取文件系統信息系統調用函數。intsys_ustat (int dev, struct ustat *ubuf){  return -ENOSYS;}//// 設置文件訪問和修改時間。// 參數filename 是文件名，times 是訪問和修改時間結構指針。// 如果times 指針不為NULL，則取utimbuf 結構中的時間信息來設置文件的訪問和修改時間。如果// times 指針是NULL，則取系統當前時間來設置指定文件的訪問和修改時間域。intsys_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 should we use the real or effective uid? BSD uses the real uid,* so as to make this call useful to setuid programs.*//** 文件屬性XXX，我們該用真實用戶id 還是有效用戶id？BSD 系統使用了真實用戶id，* 以使該調用可以供setuid 程序使用。（注：POSIX 標準建議使用真實用戶ID）*///// 檢查對文件的訪問權限。// 參數filename 是文件名，mode 是屏蔽碼，由R_OK(4)、W_OK(2)、X_OK(1)和F_OK(0)組成。// 如果請求訪問允許的話，則返回0，否則返回出錯碼。intsys_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 we are doing this test last because we really should be* swapping the effective with the real user id (temporarily),* and then calling suser() routine. If we do call the* suser() routine, it needs to be called last.*//** XXX 我們最后才做下面的測試，因為我們實際上需要交換有效用戶id 和* 真實用戶id（臨時地），然后才調用suser()函數。如果我們確實要調用* suser()函數，則需要最后才被調用。*/// 如果當前用戶id 為0（超級用戶）并且屏蔽碼執行位是0 或文件可以被任何人訪問，則返回0。  if ((!current->uid) && (!(mode & 1) || (i_mode & 0111)))    return 0;// 否則返回出錯碼。  return -EACCES;}//// 改變當前工作目錄系統調用函數。// 參數filename 是目錄名。// 操作成功則返回0，否則返回出錯碼。intsys_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，否則返回出錯碼。intsys_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，否則返回出錯碼。intsys_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，否則返回出錯碼。intsys_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)intsys_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 are somewhat special (ttyxx major==4, tty major==5) *//* 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;	}/* Likewise with block-devices: check for floppy_change *//* 同樣對于塊設備文件：需要檢查盤片是否被更換 */// 如果打開的是塊設備文件，則檢查盤片是否更換，若更換則需要是高速緩沖中對應該設備的所有// 緩沖塊失效。  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()函數相同。// 成功則返回文件句柄，否則返回出錯碼。intsys_creat (const char *pathname, int mode){  return sys_open (pathname, O_CREAT | O_TRUNC, mode);}// 關閉文件系統調用函數。// 參數fd 是文件句柄。// 成功則返回0，否則返回出錯碼。intsys_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);}