open.c

jhluroom

/*
* linux/fs/open.c
*
* (C) 1991 Linus Torvalds
*/
#include string.h>
#include errno.h>
#include fcntl.h>
#include sys/types.h>
#include utime.h>
#include sys/stat.h>
#include linux/sched.h>
#include linux/tty.h>
#include linux/kernel.h>
#include asm/segment.h>
int sys_ustat(int dev, struct ustat * ubuf)// 取文件系统信息系统调用函数。
{
    return -ENOSYS;
}
int sys_utime(char * filename, struct utimbuf * times)// 设置文件访问和修改时间
{
    struct m_inode * inode;
    long actime,modtime;
    if (!(inode=namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -ENOENT;
    if (times) {// 如果访问和修改时间数据结构指针不为NULL，则从结构中读取用户设置的时间值
        actime = get_fs_long((unsigned long *) &times->actime);//置访问时间
        modtime = get_fs_long((unsigned long *) &times->modtime);//置修改时间
    } else
        actime = modtime = CURRENT_TIME;// 否则将访问和修改时间置为当前时间
    inode->i_atime = actime;// 最后访问时间。
    inode->i_mtime = modtime;// 修改时间（自1970.1.1:0 算起，秒）。
    inode->i_dirt = 1;// 已修改(脏)标志。
    iput(inode);// 释放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.
*/
int sys_access(const char * filename,int mode)// 检查对文件的访问权限
{
    struct m_inode * inode;
    int res, i_mode;
    mode &= 0007;// 屏蔽码由低3 位组成，因此清除所有高比特位
    if (!(inode=namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -EACCES;
    i_mode = res = inode->i_mode & 0777;//取文件的属性码
    iput(inode);//释放inode节点
    if (current->uid == inode->i_uid)// 如果当前进程是该文件的宿主，
        res >>= 6;//则取文件宿主属性
    else if (current->gid == inode->i_gid)//否则如果当前进程是与该文件同属一组
        res >>= 6;//则取文件组属性
    if ((res & 0007 & mode) == mode)// 如果文件属性具有查询的属性位，
        return 0;//则访问许可，返回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.
     */
    if ((!current->uid) &&
     (!(mode & 1) || (i_mode & 0111)))//如果当前用户id 为0（超级用户）并且屏蔽码执行位是0 或文件可以被任何人访问，则返回0
        return 0;
    return -EACCES;
}
int sys_chdir(const char * filename)// 改变当前工作目录系统调用函数
{
    struct m_inode * inode;
    if (!(inode = namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -ENOENT;
    if (!S_ISDIR(inode->i_mode)) {// 如果该i 节点不是目录的i 节点，
        iput(inode);//则释放该节点，
        return -ENOTDIR;//返回出错码
    }
    iput(current->pwd);// 释放当前进程原工作目录i 节点
    current->pwd = inode;//并指向该新置的工作目录i 节点
    return (0);
}
int sys_chroot(const char * filename)// 改变根目录系统调用函数
{
    struct m_inode * inode;
    if (!(inode=namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -ENOENT;
    if (!S_ISDIR(inode->i_mode)) {// 如果该i 节点不是目录的i 节点，
        iput(inode);//则释放该节点，
        return -ENOTDIR;
    }
    iput(current->root);// 释放当前进程的根目录i 节点
    current->root = inode;//并重置为这里指定目录名的i 节点
    return (0);
}
int sys_chmod(const char * filename,int mode)// 修改文件属性系统调用函数
{
    struct m_inode * inode;
    if (!(inode=namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -ENOENT;
    if ((current->euid != inode->i_uid) && !suser()) {// 如果当前进程的有效用户id 不等于文件i 节点的用户id，并且当前进程不是超级用户
        iput(inode);//则释放该节点
        return -EACCES;
    }
    inode->i_mode = (mode & 07777) | (inode->i_mode & ~07777);/// 重新设置i 节点的文件属性
    inode->i_dirt = 1;//并置该i 节点已修改标志
    iput(inode);//则释放该节点
    return 0;
}
int sys_chown(const char * filename,int uid,int gid)// 修改文件宿主系统调用函数
{
    struct m_inode * inode;
    if (!(inode=namei(filename)))// 根据给定的目录文件名找到对应的i 节点
        return -ENOENT;
    if (!suser()) {// 若当前进程不是超级用户
        iput(inode);
        return -EACCES;
    }
    inode->i_uid=uid;// 用户id（文件拥有者标识符）。
    inode->i_gid=gid;// 组id(文件拥有者所在的组)
    inode->i_dirt=1;// 已修改(脏)标志
    iput(inode);//则释放该节点
    return 0;
}
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 ; fdNR_OPEN ; fd++)// 搜索进程结构中文件结构指针数组，查找一个空闲项，若已经没有空闲项，则返回出错码
        if (!current->filp[fd])
            break;
    if (fd>=NR_OPEN)
        return -EINVAL;
    current->close_on_exec &= ~(1fd);// 设置执行时关闭文件句柄位图，复位对应比特位
    f=0+file_table;//令f 指向文件表数组开始处
    for (i=0 ; iNR_FILE ; i++,f++)//搜索空闲文件结构项(句柄引用计数为0 的项)，
        if (!f->f_count) break;
    if (i>=NR_FILE)
        return -EINVAL;
    (current->filp[fd]=f)->f_count++;// 让进程的对应文件句柄的文件结构指针指向搜索到的文件结构，并令句柄引用计数递增1
    if ((i=open_namei(filename,flag,mode,&inode))0) {//文件打开namei 函数,成功返回0，否则返回出错码，同时返回对应文件的inode节点指针
        current->filp[fd]=NULL;
        f->f_count=0;
        return i;
    }
/* ttys are somewhat special (ttyxx major==4, tty major==5) */
    if (S_ISCHR(inode->i_mode))// 如果是字符设备文件
        if (MAJOR(inode->i_zone[0])==4) {//那么如果设备号是4 的话
            if (current->leader && current->tty0) {
                current->tty = MINOR(inode->i_zone[0]);//设置当前进程的tty 号为该i 节点的子设备号
                tty_table[current->tty].pgrp = current->pgrp;//设置当前进程tty 对应的tty 表项的父进程组号等于进程的父进程组号
            }
        } else if (MAJOR(inode->i_zone[0])==5)//那么如果设备号是5的话
            if (current->tty0) {//若当前进程没有tty，则说明出错，释放i 节点和申请到的文件结构
                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]);//检查磁盘是否更换，
    f->f_mode = inode->i_mode;// 文件操作模式（RW 位）
    f->f_flags = flag;// 文件打开和控制的标志
    f->f_count = 1;// 对应文件句柄（文件描述符）数
    f->f_inode = inode;// 指向对应i 节点
    f->f_pos = 0;// 文件位置（读写偏移值）
    return (fd);
}
int sys_creat(const char * pathname, int mode)// 创建文件系统调用函数
{
    return sys_open(pathname, O_CREAT | O_TRUNC, mode);// 打开（或创建）文件系统调用函数
}
int sys_close(unsigned int fd)// 关闭文件系统调用函数。
{   
    struct file * filp;
    if (fd >= NR_OPEN)// 若文件句柄值大于程序同时能打开的文件数，则返回出错码
        return -EINVAL;
    current->close_on_exec &= ~(1fd);// 复位进程的执行时关闭文件句柄位图对应位
    if (!(filp = current->filp[fd]))// 若该文件句柄对应的文件结构指针是NULL，则返回出错码
        return -EINVAL;
    current->filp[fd] = NULL;// 置该文件句柄的文件结构指针为NULL
    if (filp->f_count == 0)//对应文件结构中的句柄引用计数已经为0
        panic("Close: file count is 0");
    if (--filp->f_count)// 将对应文件结构的句柄引用计数减1，如果还不为0，则返回0（成功）。
        return (0);
    iput(filp->f_inode);//若已等于0，说明该 文件已经没有句柄引用，则释放该文件i 节点，返回0
    return (0);
}


本文来自ChinaUnix博客，如果查看原文请点：http://blog.chinaunix.net/u3/90876/showart_2031814.html