access(判断是否具有存取文件的权限)

相关函数: stat, open, chmod, chown, setuid,

表头文件: #include "unistd.h"

定义函数: int access(const char *pathname, int mode);

函数说明: access()会检查是否可以读/写某一已存在的文件。 参数mode有几种情况组合,R_OK,W_OK,X_OK和F_OK。R_OK,W_OK与X_OK用来检查文件是否具有读取、写入和执行的权限。 F_OK则是用来判断该文件是否存在。由于access()只作权限的核查,并不理会文件形态或文件内容, 因此,如果一目录表示为"可写入",表示可以在该目录中建立新文件等操作,而非意味此目录可以被当做文件处理。 例如,你会发现DOS的文件都具有"可执行"权限,但用execve()执行时则会失败。

返回值: 若所有欲查核的权限都通过了检查则返回0值,表示成功,只要有一权限被禁止则返回-1。 错误代码
EACCESS 参数pathname 所指定的文件不符合所要求测试的权限。
EROFS 欲测试写入权限的文件存在于只读文件系统内。
EFAULT 参数pathname指针超出可存取内存空间。
EINVAL 参数mode 不正确。
ENAMETOOLONG 参数pathname太长。
ENOTDIR 参数pathname为一目录。
ENOMEM 核心内存不足
ELOOP 参数pathname有过多符号连接问题。
EIO I/O 存取错误。

附加说明: 使用access()作用户认证方面的判断要特别小心,例如在access()后再做open()的空文件可能会造成系统安全上的问题。

范例


			/* 判断是否允许读取/etc/passwd */
          #include "unistd.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              if (access("/etc/passwd", R_OK) == 0)
                  printf("/etc/passwd can be read\n");
              return 0;
          }
			

执行结果


          /etc/passwd can be read
			

alphasort(依字母顺序排序目录结构)

相关函数: scandir, qsort

表头文件: #include "dirent.h"

定义函数: int alphasort(const struct dirent **a, const struct dirent **b);

函数说明: alphasort()为scandir()最后调用qsort()函数时传给qsort()作为判断的函数,详细说明请参考scandir()及qsort()。

返回值: 参考qsort()。

范例: /* 读取/目录下所有的目录结构,并依字母顺序排列*/

执行结果


          #include "stdio.h"
          #include "dirent.h"

          int main(int argc, char const *argv[])
          {
              struct dirent **namelist;
              int i, total;
              total = scandir("/", &namelist , 0, alphasort);
              if (total  < 0)
                  perror("scandir");
              else {
                  for (i = 0; i < total; i++)
                      printf("%s\n", namelist[i]->d_name);
                  printf("total = %d\n", total);
              }
              return 0;
          }
			

结果


          .
          ..
          bin
          boot
          cdrom
          dev
          etc
          home
          initrd.img
          lib
          lib64
          lost+found
          media
          mnt
          opt
          proc
          root
          run
          sbin
          srv
          sys
          tmp
          usr
          var
          vmlinuz
          total = 25
			

chdir(改变当前的工作(目录)

相关函数: getcwd, chroot

表头文件: #include "unistd.h"

定义函数: int chdir(const char *path);

函数说明: chdir()用来将当前的工作目录改变成以参数path所指的目录。

返回值: 执行成功则返回0,失败返回-1,errno为错误代码。

范例


          #include "unistd.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              chdir("/tmp");
              printf("current working directory: %s\n", getcwd(NULL, NULL));
              return 0;
          }
			

执行结果


          current working directory: /tmp
			

chmod(改变文件的权限)

相关函数: fchmod, stat, open, chown

表头文件: #include "sys/types.h" #include "sys/stat.h"

定义函数: int chmod(const char *path, mode_t mode);

函数说明: chmod()会依参数mode 权限来更改参数path 指定文件的权限。

参数: mode 有下列数种组合: S_ISUID 04000 文件的(set user-id on execution)位
S_ISGID 02000 文件的(set group-id on execution)位
S_ISVTX 01000 文件的sticky位
S_IRUSR(S_IREAD) 00400 文件所有者具可读取权限
S_IWUSR(S_IWRITE)00200 文件所有者具可写入权限
S_IXUSR(S_IEXEC) 00100 文件所有者具可执行权限
S_IRGRP 00040 用户组具可读取权限
S_IWGRP 00020 用户组具可写入权限
S_IXGRP 00010 用户组具可执行权限
S_IROTH 00004 其他用户具可读取权限
S_IWOTH 00002 其他用户具可写入权限
S_IXOTH 00001 其他用户具可执行权限
只有该文件的所有者或有效用户识别码为0,才可以修改该文件权限。 基于系统安全,如果欲将数据写入一执行文件,而该执行文件具有S_ISUID或S_ISGID权限,则这两个位会被清除。 如果一目录具有S_ISUID 位权限,表示在此目录下只有该文件的所有者或root可以删除该文件。

返回值: 权限改变成功返回0,失败返回-1,错误原因存于errno。

错误代码: EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同,而且也不具root权限。
EACCESS 参数path所指定的文件无法存取。
EROFS 欲写入权限的文件存在于只读文件系统内。
EFAULT 参数path指针超出可存取内存空间。
EINVAL 参数mode不正确
ENAMETOOLONG 参数path太长
ENOENT 指定的文件不存在
ENOTDIR 参数path路径并非一目录
ENOMEM 核心内存不足
ELOOP 参数path有过多符号连接问题。
EIO I/O 存取错误

范例


           /* 将/etc/passwd 文件权限设成S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH */
          #include "sys/types.h"
          #include "sys/stat.h"

          int main(int argc, char const *argv[])
          {
              chmod("/etc/passwd", S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH);
              return 0;
          }
			

chown(改变文件的所有者)

相关函数: fchown, lchown, chmod

表头文件: #include "sys/types.h" #include "unistd.h"

定义函数: int chown(const char * path, uid_t owner,gid_t group);

函数说明: chown()会将参数path指定文件的所有者变更为参数owner代表的用户,而将该文件的组变更为参数group组。 如果参数owner或group为-1,对应的所有者或组不会有所改变。root与文件所有者皆可改变文件组,但所有者必须是参数group组的成员。 当root用chown()改变文件所有者或组时,该文件若具有S_ISUID或S_ISGID权限,则会清除此权限位, 此外如果具有S_ISGID权限但不具S_IXGRP位,则该文件会被强制锁定,文件模式会保留。

返回值: 成功则返回0,失败返回-1,错误原因存于errno。

范例: 参考chmod()。

chroot(改变根目录)

相关函数: chdir,

表头文件: #include "unistd.h"

定义函数: int chroot(const char * path);

函数说明: chroot()用来改变根目录为参数path 所指定的目录。只有超级用户才允许改变根目录,子进程将继承新的根目录。

返回值: 调用成功则返回0,失败则返-1,错误代码存于errno。

错误代码: EPERM 权限不足,无法改变根目录。
EFAULT 参数path指针超出可存取内存空间。
ENAMETOOLONG 参数path太长。
ENOTDIR 路径中的目录存在但却非真正的目录。
EACCESS 存取目录时被拒绝
ENOMEM 核心内存不足。
ELOOP 参数path有过多符号连接问题。
EIO I/O 存取错误。

closedir(关闭目录)

相关函数: opendir,

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: int closedir(DIR *dir);

函数说明: closedir()关闭参数dir所指的目录流。

返回值: 关闭成功则返回0,失败返回-1,错误原因存于errno 中。

错误代码: EBADF 参数dir为无效的目录流

范例: 参考readir()。

fchdir(改变当前的工作目录)

相关函数: getcwd, chroot

表头文件: #include "unistd.h"

定义函数: int fchdir(int fd);

函数说明: fchdir()用来将当前的工作目录改变成以参数fd所指的文件描述词。

返回值执: 行成功则返回0,失败返回-1,errno为错误代码。

closedir(关闭目录)

相关函数: opendir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: int closedir(DIR *dir);

函数说明: closedir()关闭参数dir所指的目录流。

返回值: 关闭成功则返回0,失败返回-1,错误原因存于errno 中。

错误代码: EBADF 参数dir为无效的目录流

范例: 参考readir()。

fchdir(改变当前的工作目录)

相关函数: getcwd, chroot

表头文件: #include "unistd.h"

定义函数: int fchdir(int fd);

函数说明: fchdir()用来将当前的工作目录改变成以参数fd所指的文件描述词。

返回值执: 行成功则返回0,失败返回-1,errno为错误代码。

范例


          #include "sys/types.h"
          #include "sys/stat.h"
          #include "fcntl.h"
          #include "unistd.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              int fd;
              fd = open("/tmp", O_RDONLY);
              fchdir(fd);
              printf("current working directory : %s \n", getcwd(NULL, NULL));
              close(fd);
              return 0;
          }
			

执行结果


          current working directory : /tmp
			

fchmod(改变文件的权限)

相关函数: chmod, stat, open, chown

表头文件: #include "sys/types.h" #include "sys/stat.h"

定义函数: int fchmod(int fildes,mode_t mode);

函数说明: fchmod()会依参数mode权限来更改参数fildes所指文件的权限。参数fildes为已打开文件的文件描述词。参数mode请参考chmod()。

返回值: 权限改变成功则返回0,失败返回-1,错误原因存于errno。

错误原因: EBADF 参数fildes为无效的文件描述词。
EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同,而且也不具root权限。
EROFS 欲写入权限的文件存在于只读文件系统内。
EIO I/O 存取错误。

fchown(改变文件的所有者)

相关函数: chown, lchown, chmod

表头文件: #include "sys/types.h" #include "unistd.h"

定义函数: int fchown(int fd, uid_t owner, gid_t group);

函数说明: fchown()会将参数fd指定文件的所有者变更为参数owner代表的用户,而将该文件的组变更为参数group组。 如果参数owner或group为-1,对映的所有者或组有所改变。参数fd为已打开的文件描述词。 当root用fchown()改变文件所有者或组时,该文件若具S_ISUID或S_ISGID权限,则会清除此权限位。

返回值: 成功则返回0,失败则返回-1,错误原因存于errno。

错误代码:
EBADF 参数fd文件描述词为无效的或该文件已关闭。
EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同,而且也不具root权限,
或是参数owner、group不正确。
EROFS 欲写入的文件存在于只读文件系统内。
ENOENT 指定的文件不存在
EIO I/O存取错误

fstat(由文件描述词取得文件状态)

相关函数: stat, lstat, chmodchownreadlinkutime

表头文件: #include "sys/stat.h" #include "unistd.h"

定义函数: int fstat(int fildes,struct stat *buf);

函数说明: fstat()用来将参数fildes所指的文件状态,复制到参数buf所指的结构中(struct stat)。 fstat()与stat()作用完全相同,不同处在于传入的参数为已打开的文件描述词。详细内容请参考stat()。

返回值: 执行成功则返回0,失败返回-1,错误代码存于errno。

范例


          #include "sys/stat.h"
          #include "unistd.h"
          #include "fcntl.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              struct stat buf;
              int fd;
              fd = open ("/etc/passwd", O_RDONLY);
              fstat(fd, &buf);
              printf("/etc/passwd file size +%ld\n ", buf.st_size);
              return 0;
          }
			

执行结果


          /etc/passwd file size +2090
			

ftruncate(改变文件大小)

相关函数: opentruncate

表头文件: #include "unistd.h"

定义函数: int ftruncate(int fd,off_t length);

函数说明: ftruncate()会将参数fd指定的文件大小改为参数length指定的大小。 参数fd为已打开的文件描述词,而且必须是以写入模式打开的文件。如果原来的文件大小比参数length大,则超过的部分会被删去。

返回值: 执行成功则返回0,失败返回-1,错误原因存于errno。

错误代码: EBADF 参数fd文件描述词为无效的或该文件已关闭。
EINVAL 参数fd 为一socket 并非文件,或是该文件并非以写入模式打开。

getcwd(取得当前的工作目录)

相关函数: statget_current_dir_name getwd, chdir

表头文件: #include "unistd.h"

定义函数: char * getcwd(char * buf,size_t size);

函数说明: getcwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间,参数size为buf的空间大小。 在调用此函数时,buf所指的内存空间要足够大,若工作目录绝对路径的字符串长度超过参数size大小,则回值NULL,errno的值则为ERANGE。 倘若参数buf为NULL,getcwd()会依参数size的大小自动配置内存(使用malloc()), 如果参数size也为0,则getcwd()会依工作目录绝对路径的字符串程度来决定所配置的内存大小,进程可以在使用完此字符串后利用free()来释放此空间。

返回值: 执行成功则将结果复制到参数buf所指的内存空间,或是返回自动配置的字符串指针。失败返回NULL,错误代码存于errno。

范例


          #include "unistd.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              char buf[80];
              getcwd(buf, sizeof(buf));
              printf("current working directory : %s\n", buf);
              return 0;
          }
			

执行结果


          current working directory : /tmp
			

相关函数: symlink, unlink

表头文件: #include "unistd.h"

定义函数: int link (const char * oldpath,const char * newpath);

函数说明: link()以参数newpath指定的名称来建立一个新的连接(硬连接)到参数oldpath所指定的已存在文件。 如果参数newpath指定的名称为一已存在的文件则不会建立连接。

返回值: 成功则返回0,失败返回-1,错误原因存于errno。

附加说明: link()所建立的硬连接无法跨越不同文件系统,如果需要请改用symlink()。

错误代码: EXDEV 参数oldpath与newpath不是建立在同一文件系统。
EPERM 参数oldpath与newpath所指的文件系统不支持硬连接
EROFS 文件存在于只读文件系统内
EFAULT 参数oldpath或newpath 指针超出可存取内存空间。
ENAMETOLLONG 参数oldpath或newpath太长
ENOMEM 核心内存不足
EEXIST 参数newpath所指的文件名已存在。
EMLINK 参数oldpath所指的文件已达最大连接数目。
ELOOP 参数pathname有过多符号连接问题
ENOSPC 文件系统的剩余空间不足。
EIO I/O 存取错误。

lstat(由文件描述词取得文件状态)

相关函数: stat, fstat, chmod, chown, readlink, utime

表头文件: #include "sys/stat.h" #include "unistd.h"

定义函数: int lstat (const char * file_name.struct stat * buf);

函数说明: lstat()与stat()作用完全相同,都是取得参数file_name所指的文件状态,其差别在于, 当文件为符号连接时,lstat()会返回该link本身的状态。详细内容请参考stat()。

返回值: 执行成功则返回0,失败返回-1,错误代码存于errno。

x范例: 参考stat()。

opendir(打开目录)

相关函数: open, readdir, closedir, rewinddir, seekdir, telldir, scandir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: DIR *opendir(const char *name);

函数说明: opendir()用来打开参数name指定的目录,并返回DIR*形态的目录流,和open()类似,接下来对目录的读取和搜索都要使用此返回值。

返回值: 成功则返回DIR* 型态的目录流,打开失败则返回NULL。

错误代码:

EACCESS 权限不足
EMFILE 已达到进程可同时打开的文件数上限。
ENFILE 已达到系统可同时打开的文件数上限。
ENOTDIR 参数name非真正的目录
ENOENT 参数name 指定的目录不存在,或是参数name 为一空字符串。
ENOMEM 核心内存不足。

readdir(读取目录)

相关函数: open, opendir, readdir, closedir, rewinddir, seekdir, telldir, scandir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: struct dirent *readdir(DIR *dir);

函数说明: readdir()返回参数dir目录流的下个目录进入点。结构dirent定义如下:

opendir(打开目录)

相关函数: open, readdir, closedir, rewinddir, seekdir, telldir, scandir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: DIR *opendir(const char *name);

函数说明: opendir()用来打开参数name指定的目录,并返回DIR*形态的目录流,和open()类似,接下来对目录的读取和搜索都要使用此返回值。

返回值: 成功则返回DIR* 型态的目录流,打开失败则返回NULL。

错误代码: EACCESS 权限不足
EMFILE 已达到进程可同时打开的文件数上限。
ENFILE 已达到系统可同时打开的文件数上限。
ENOTDIR 参数name非真正的目录
ENOENT 参数name 指定的目录不存在,或是参数name 为一空字符串。
ENOMEM 核心内存不足。

readdir(读取目录)

相关函数: open, opendir, closedir, rewinddir, seekdir, telldir, scandir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: struct dirent *readdir(DIR *dir);

函数说明: readdir()返回参数dir目录流的下个目录进入点。结构dirent定义如下:


        struct dirent
        {
            ino_t d_ino;
            ff_t d_off;
            signed short int d_reclen;
            unsigned char d_type;
            har d_name[256;
        };
			

      d_ino 此目录进入点的inode
      d_off 目录文件开头至此目录进入点的位移
      d_reclen d_name的长度,不包含NULL字符
      d_type d_name所指的文件类型
      d_name 文件名
			

返回值: 成功则返回下个目录进入点。有错误发生或读取到目录文件尾则返回NULL。

附加说明: EBADF参数dir为无效的目录流。

readlink(取得符号连接所指的文件)

相关函数: stat, lstat, symlink

表头文件: #include "unistd.h"

定义函数: int readlink(const char *path, char *buf, size_t bufsiz);

函数说明: readlink()会将参数path的符号连接内容存到参数buf所指的内存空间, 返回的内容不是以NULL作字符串结尾,但会将字符串的字符数返回。若参数bufsiz小于符号连接的内容长度,过长的内容会被截断。

返回值: 执行成功则传符号连接所指的文件路径字符串,失败则返回-1,错误代码存于errno。

错误代码:
EACCESS 取文件时被拒绝,权限不够
EINVAL 参数bufsiz 为负数
EIO I/O 存取错误。
ELOOP 欲打开的文件有过多符号连接问题。
ENAMETOOLONG 参数path的路径名称太长
ENOENT 参数path所指定的文件不存在
ENOMEM 核心内存不足
ENOTDIR 参数path路径中的目录存在但却非真正的目录。

remove(删除文件)

相关函数: link, rename, unlink

表头文件: #include "stdio.h"

定义函数: int remove(const char * pathname);

函数说明: remove()会删除参数pathname指定的文件。如果参数pathname为一文件,则调用unlink()处理, 若参数pathname为一目录,则调用rmdir()来处理。请参考unlink()与rmdir()。

返回值: 成功则返回0,失败则返回-1,错误原因存于errno。

错误代码:
EROFS 欲写入的文件存在于只读文件系统内
EFAULT 参数pathname指针超出可存取内存空间
ENAMETOOLONG 参数pathname太长
ENOMEM 核心内存不足
ELOOP 参数pathname有过多符号连接问题
EIO I/O 存取错误。

rename(更改文件名称或位置)

相关函数: link, unlink, symlink

表头文件: #include "stdio.h"

定义函数: int rename(const char * oldpath,const char * newpath);

函数说明: rename()会将参数oldpath 所指定的文件名称改为参数newpath所指的文件名称。若newpath所指定的文件已存在,则会被删除。

返回值: 执行成功则返回0,失败返回-1,错误原因存于errno

范例:


			/* 设计一个CLI下的rename指令rename 旧文件名新文件名*/
          #include  "stdio.h"

          int main(int argc, char const *argv[])
          {
              if (argc < 3)
              {
                  printf("Usage: %s old_name new_name\n", argv[0]);
                  return 0;
              }
              printf("%s=>%s", argv[1], argv[2]);
              if (rename(argv[1], argv[2]) < 0)
                  printf("error!\n");
              else
                  printf("ok!\n");
              return 0;
          }
			

rewinddir(重设读取目录的位置为开头位置)

相关函数: open, opendir, closedir, telldir, seekdir, readdir, scandir

表头文件: #include "sys/types.h" #include "dirent.h"

定义函数: void rewinddir(DIR *dir);

函数说明: rewinddir()用来设置参数dir 目录流目前的读取位置为原来开头的读取位置。

错误代码: EBADF dir为无效的目录流

seekdir(设置下回读取目录的位置)

相关函数: open, opendir, closedir, rewinddir, telldir, readdir, scandir open, opendir, closedir, rewinddir, telldir, readdir, scandir

表头文件: #include "dirent.h"

定义函数: void seekdir(DIR *dir, off_t offset);

函数说明: seekdir()用来设置参数dir目录流目前的读取位置,在调用readdir()时便从此新位置开始读取。参数offset代表距离目录文件开头的偏移量。

错误代码: EBADF 参数dir为无效的目录流

stat(取得文件状态)

相关函数: fstat, lstat, chmod, chown, readlink, utime,

表头文件: #include "sys/stat.h" #include "unistd.h"

定义函数: int stat(const char * file_name,struct stat *buf);

函数说明: stat()用来将参数file_name所指的文件状态,复制到参数buf所指的结构中。 下面是struct stat内各参数的说明:


        struct stat
        {
            dev_t st_dev; /*文件的设备编号*/
            ino_t st_ino; /*文件的i-node*/
            mode_t st_mode; /*文件的类型和存取的权限*/
            nlink_t st_nlink; /*连到该文件的硬连接数目,刚建立的文件值为1*/
            uid_t st_uid; /*文件所有者的用户识别码*/
            gid_t st_gid; /*文件所有者的组识别码*/
            dev_t st_rdev; /*若此文件为装置设备文件,则为其设备编号*/
            off_t st_size; /*文件大小,以字节计算*/
            unsigned long st_blksize; /*文件系统的I/O 缓冲区大小*/
            unsigned long st_blocks; /*占用文件区块的个数,每一区块大小为512 个字节*/
            time_t st_atime; /*文件最近一次被存取或被执行的时间*/
            time_t st_mtime; /*文件最后一次被修改的时间*/
            time_t st_ctime; /*i-node最近一次被更改的时间*/
        };
        /*
          st_atime一般只有在用mknod、utime、read、write与tructate时改变
          st_mtime一般只有在用mknod、utime和write时才会改变
          st_ctime会在文件所有者、组、权限被更改时更新
        */
			
先前所描述的st_mode 则定义了下列数种情况:

        S_IFMT 0170000 文件类型的位遮罩
        S_IFSOCK 0140000 scoket
        S_IFLNK 0120000 符号连接
        S_IFREG 0100000 一般文件
        S_IFBLK 0060000 区块装置
        S_IFDIR 0040000 目录
        S_IFCHR 0020000 字符装置
        S_IFIFO 0010000 先进先出
        S_ISUID 04000 文件的(set user-id on execution)位
        S_ISGID 02000 文件的(set group-id on execution)位
        S_ISVTX 01000 文件的sticky位
        S_IRUSR(S_IREAD) 00400 文件所有者具可读取权限
        S_IWUSR(S_IWRITE)00200 文件所有者具可写入权限
        S_IXUSR(S_IEXEC) 00100 文件所有者具可执行权限
        S_IRGRP 00040 用户组具可读取权限
        S_IWGRP 00020 用户组具可写入权限
        S_IXGRP 00010 用户组具可执行权限
        S_IROTH 00004 其他用户具可读取权限
        S_IWOTH 00002 其他用户具可写入权限
        S_IXOTH 00001 其他用户具可执行权限
      上述的文件类型在POSIX 中定义了检查这些类型的宏定义
        S_ISLNK (st_mode) 判断是否为符号连接
        S_ISREG (st_mode) 是否为一般文件
        S_ISDIR (st_mode)是否为目录
        S_ISCHR (st_mode)是否为字符装置文件
        S_ISBLK (s3e) 是否为先进先出
        S_ISSOCK (st_mode) 是否为socket
			
若一目录具有sticky 位(S_ISVTX),则表示在此目录下的文件只能被该文件所有者、此目录所有者或root来删除或改名。

返回值: 执行成功则返回0,失败返回-1,错误代码存于errno

错误代码:


		    ENOENT 参数file_name指定的文件不存在
		    ENOTDIR 路径中的目录存在但却非真正的目录
		    ELOOP 欲打开的文件有过多符号连接问题,上限为16符号连接
		    EFAULT 参数buf为无效指针,指向无法存在的内存空间
		    EACCESS 存取文件时被拒绝
		    ENOMEM 核心内存不足
			ENAMETOOLONG 参数file_name的路径名称太长
			

范例


          #include "sys/stat.h"
          #include "unistd.h"
          #include "stdio.h"

          int main(int argc, char const *argv[])
          {
              struct stat buf;
              stat ("/etc/passwd", &buf);
              printf("/etc/passwd file size = %ld \n", buf.st_size);
              return 0;
          }
			

执行结果


          /etc/passwd file size = 2090
			

相关函数: link, unlink

表头文件: #include "unistd.h"

定义函数: int symlink(const char *oldpath, const char *newpath);

函数说明: symlink()以参数newpath指定的名称来建立一个新的连接(符号连接)到参数oldpath所指定的已存在文件。 参数oldpath指定的文件不一定要存在,如果参数newpath指定的名称为一已存在的文件则不会建立连接。

返回值: 成功则返回0,失败返回-1,错误原因存于errno。

错误代码:



		    EPERM 参数oldpath与newpath所指的文件系统不支持符号连接
		    EROFS 欲测试写入权限的文件存在于只读文件系统内
		    EFAULT 参数oldpath或newpath指针超出可存取内存空间。
		    ENAMETOOLONG 参数oldpath或newpath太长
		    ENOMEM 核心内存不足
		    EEXIST 参数newpath所指的文件名已存在。
		    EMLINK 参数oldpath所指的文件已达到最大连接数目
		    ELOOP 参数pathname有过多符号连接问题
		    ENOSPC 文件系统的剩余空间不足
		    EIO I/O 存取错误
			

telldir(取得目录流的读取位置)

相关函数: open, opendir, closedir, rewinddir, seekdir, readdir, scandir

表头文件: #include "dirent.h"

定义函数: off_t telldir(DIR *dir);

函数说明: telldir()返回参数dir目录流目前的读取位置。此返回值代表距离目录文件开头的偏移量返回值返回下个读取位置,有错误发生时返回-1。

错误代码: EBADF参数dir为无效的目录流。

truncate(改变文件大小)

相关函数: open, ftruncate

表头文件: #include "unistd.h"

定义函数: int truncate(const char *path, off_t length);

函数说明: truncate()会将参数path 指定的文件大小改为参数length 指定的大小。如果原来的文件大小比参数length大,则超过的部分会被删去。

返回值: 执行成功则返回0,失败返回-1,错误原因存于errno。

umask(设置建立新文件时的权限遮罩)

相关函数: creat, open creat, open

表头文件: #include "sys/types.h" #include "sys/stat.h"

定义函数: mode_t umask(mode_t mask);

函数说明: umask()会将系统umask值设成参数mask&0777后的值,然后将先前的umask值返回。 在使用open()建立新文件时,该参数mode并非真正建立文件的权限,而是(mode&~umask)的权限值。 例如,在建立文件时指定文件权限为0666,通常umask值默认为022, 则该文件的真正权限则为0666&~022=0644,也就是rw-r--r--返回值此调用不会有错误值返回。 返回值为原先系统的umask值。

相关函数: link, rename, remove

表头文件: #include "unistd.h"

定义函数: int unlink(const char *pathname);

函数说明: unlink()会删除参数pathname指定的文件。如果该文件名为最后连接点,但有其他进程打开了此文件, 则在所有关于此文件的文件描述词皆关闭后才会删除。如果参数pathname为一符号连接,则此连接会被删除。

返回值: 成功则返回0,失败返回-1,错误原因存于errno

错误代码:


		    EROFS 文件存在于只读文件系统内
		    EFAULT 参数pathname指针超出可存取内存空间
		    ENAMETOOLONG 参数pathname太长
		    ENOMEM 核心内存不足
		    ELOOP 参数pathname 有过多符号连接问题
		    EIO I/O 存取错误
			

utime(修改文件的存取时间和更改时间)

相关函数: utimes, stat

表头文件: #include "sys/types.h" #include "utime.h"

定义函数: int utime(const char * filename,struct utimbuf * buf);

函数说明: utime()用来修改参数filename文件所属的inode存取时间。结构utimbuf定义如下:


		    struct utimbuf
		    {
		    time_t actime;
		    time_t modtime;
		    };
			

返回值: 如果参数buf为空指针(NULL),则该文件的存取时间和更改时间全部会设为目前时间。执行成功则返回0,失败返回-1,错误代码存于errno。

错误代码: EACCESS 存取文件时被拒绝,权限不足 ENOENT 指定的文件不存在。

utimes(修改文件的存取时间和更改时间)

相关函数: utime, stat

表头文件: #include "sys/types.h" #include "utime.h"

定义函数: int utimes(char * filename.struct timeval *tvp);

函数说明: utimes()用来修改参数filename文件所属的inode存取时间和修改时间。结构timeval定义如下:


		    struct timeval
		    {
		    long tv_sec;
		    long tv_usec; /* 微妙*/
		    };
			

返回值: 参数tvp指向两个timeval结构空间,和utime()使用的utimebuf结构比较, tvp[0].tc_sec则为utimbuf.actime,tvp]1].tv_sec为utimbuf.modtime。执行成功则返回0。失败返回-1,错误代码存于errno。

错误代码: EACCESS 存取文件时被拒绝,权限不足 ENOENT 指定的文件不存在