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