C语言文件操作函数

整体概述

• endgrent()：关闭文件（关闭组文件）
• endpwent()：关闭文件（关闭密码文件）
• endutent()：关闭文件（关闭utmp文件）
• fgetgrent()：读取组格式函数
• fgetpwent()：读取密码格式
• getdgid()：获得组识别码
• geteuid()：获取用户识别码函数
• getgid()：获取组识别码函数
• getgrent()：从组文件中取得账号的数据
• getgrgid()：从组文件中取得指定gid的数据
• getgrnam()：从组文件中取得指定组的数据
• getgroups()：获取组代码函数
• getpw()：取得指定用户的密码文件数据
• getpwent()：从密码文件中取得账号的数据
• getpwnam()：从密码文件中取得指定账号的数据
• getpwuid()：从密码文件中取得指定uid的数据
• getuid()：取得真实的用户识别码
• getutent()：从utmp文件中取得账号登录数据
• getutid()：从utmp文件中查找特定的记录
• getutline()：文件查找函数（从utmp文件中查找特定的）
• initgroups()：初始化组清单
• pututline()：将utmp记录写入文件
• setuid()：设置有效的用户识别码
• setfsgid()：设置文件系统的组识别码
• setfsuid()：设置文件系统的用户识别码
• setgid()：设置真实的组识别码
• setgrent()：从文件读取组文件中的数据
• setgroups()：设置组代码函数
• setpwent()：从头读取组文件中的组数据
• setregid()：设置真实及有效的组识别码
• setreuid()：设置真实及有效的用户识别码
• setuid()：设置真实的用户识别码
• setutent()：从头读取utmp文件中的登录数据
• utmpname()：设置文件路径
• close()：关闭文件
• create()：创建文件函数
• dup()：复制文件描述词
• dup2()：复制文件描述词
• fcntl()：文件描述词操作函数
• flock()：解除锁定文件
• fsync()：将缓冲区数据写回磁盘
• lseek()：移动文件的读写位置
• mkstemp()：建立临时文件
• open()：打开文件函数
• read()：读文件函数（由已打开的文件读取数据）
• sync()：写文件函数（将缓冲区数据写回磁盘）
• write()：写文件函数
• clearerr()：清除文件流的错误旗标
• fclose()：关闭打开的文件
• fdopen()：将文件描述词转为文件指针
• feof()：检查文件流是否读到了文件尾
• fflush()：更新缓冲区
• fgetc()：读文件函数（由文件中读取一个字符）
• fgets()：读取文件字符串
• fileno()：获取文件流所使用的文件描述词
• fputc()：写文件函数（将一指定字符写入文件流中）
• fputs()：写文件函数（将一指定的字符串写入文件）
• fread()：读文件函数（从文件流读取数据）
• freopen()：打开文件函数，不能够获得文件句柄
• fseek()：移动文件流的读写位置
• ftell()：取得文件流的读取位置
• fwrite()：写文件函数（将数据流写入文件中）
• mktemp()：产生唯一临时文件名
• setbuffer()：设置文件流的缓冲区
• setlinebuf()：设置文件流为线性缓冲区

详细介绍

• endgrent()函数

  void endgrent(void);

  函数说明：endgrent()用来关闭由getgrent()所打开的密码文件。

• endpwent()函数

  void endpwent(void);

  函数说明：endpwent()用来关闭由getpwent()所打开的密码文件

• endutent()函数

  void endutent(void);

  函数说明：endutent()用来关闭由getutent所打开的utmp文件。

• fgetgrent()函数

  struct groups * getgrent(FILE *stream);

  函数说明：getgrent()从参数stream指定的文件读取一行数据，然后以group结构将该数据返回。参数stream所指定的文件必须和etc/group相同的格式。

  返回值：返回group结构数据，如果返回NULL，则表示已无数据或有错误发生。

• fgetpwent()函数

  struct passwd *fgetpwent(FILE *stream);

  函数说明：fgetpwent()会从参数stream指定的文件读取一行数据，然后以passwd结构将该数据返回。参数stream所指定的文件必须和/etc/passwd相同的格式。

  返回值：返回passwd结构数据，如果返回NULL，则表示已无数据或有错误发生。

• getegid()函数

  gid_t getgid(void);

  函数说明：getegid()用来取得执行目前进程有效组识别码。有效的组识别码用来决定进程执行时组的权限。

  返回值：返回有效的组识别码。

• getuid()函数

  uid_t geteuid(void);

  函数说明：geteuid()用来取得执行目前进程有效的用户识别码。有效的用户识别码用来决定用户进程执行的权限，借由此改变此值，进程可以获得额外的权限。倘若执行文件的setID位已被设置，该文件执行时，其进程的euid值便会设成该文件所有者的uid。例如，执行文件/usr/bin/passwd的权限为-r-s–x–x，其s位即为setID(SUID)位，而当任何用户在执行passwd时其有效的用户识别码会被设成passwd所有者的uid值，即root的uid值为0。

  返回值：返回有效的用户识别码。

• getgid()函数

  gid_t getgid(void);

  函数说明：getgid()用来取得执行目前进程的组识别码。

  返回值：返回组识别码。

• getgrent()函数

  struct group *getgrent(void);

  函数说明：getgrent()用来从组文件(/etc/group)中读取一项组数据，该数据以group结构返回。第一次调用时会取得第一项组数据，之后没调用一次就会返回下一项数据，直到已无任何数据时返回NULL。

  返回值：返回group结构数据，如果返回NULL，则表示已无数据或有错误发生。错误代码：ENOMEM为内存不足，无法配置group结构。

  注意：getgrent()在第一次调用时会打开组文件，读取数据完毕后可使用endgrent()来关闭该组文件。

• getgrgid()函数

  struct group *getgrgid(gid_t gid);

  函数说明：getgrgid()用来依参数gid指定的组识别码逐一搜索组文件，找到时便将该组的数据以group结构返回。

  返回值：返回group数据结构，如果返回NULL，则表示已无数据或有错误发生。

• getgrnam()函数

  struct group *getgrnam(const char *name);

  函数说明：getgrnam()用来逐一搜索参数指定的组名称，找到时便该组的数据以group结构返回。

  返回值：返回group结构数据，如果返回NULL，则表示已无数据或有错误发生。

• getgroups()函数

  int getgroups(int size, gid_t list[]);

  函数说明：getgroup()用来取得目前用户所属的组代码。参数size为list[]所能容纳的gid_t数目。如果size值为0，此函数仅会返回用户所属的组数。

  返回值：返回组识别码，如果有UC哦呜则返回-1。错误代码：EFAULT，参数list数组地址不合法；EINVAL，参数size值不足以容纳所有的组。

• getpw()函数

  int getpw(uid_t uid, char *buf);

  函数说明：getpw()会从/etc/passwd中查找符合参数uid所指定的用户账号数据，找不到相关数据就返回-1。

  返回值：返回0表示成功，有错误发生时返回-1。

  注意：getpw()会有潜在的安全性问题，请尽量使用别的函数取代；使用shadow的系统已经把用户密码抽出/etc/passwd，因此使用getpw()取得的密码降维’*’。

• getpwent()函数

  struct passwd *getpwent(void);

  函数说明：getpwent()用来从密码文件(/etc/passwd)中读取一项用户数据，该用户的数据以passwd结构返回。第一次调用时会取得第一位用户数据，之后每次调用一次就会返回下一项数据，直到已无任何数据时返回NULL。

  返回值：返回passwd数据结构，如果返回NULL，则表示已无数据，或有错误发生。

  注意：getpwent()在第一次调用时会打开密码文件，读取数据完毕后可使用endpwent()来关闭该密码文件。

• getpwnam()函数

  struct passwd * getpwnam(const char *name);

  函数说明：getpwam()用来逐一搜索参数name指定的账号名称，找到时便将该用户的数据以passwd结构返回。

  返回值：返回passwd结构数据，如果返回NULL，则表示已无数据，或有错误发生。

• getpwuid()函数

  struct passwd * getpwuid(uid_t uid);

  函数说明：getpwuid()用来逐一搜索参数uid指定的用户识别码，找到时便将该用户的数据以结构返回。

  返回值：返回passwd结构数据，如果返回NULL，则表示已无数据，或者有错误发生。

• getuid()函数

  uid_t getuid(void);

  函数说明：getuid()用来取得执行目前进程的用户识别码。

  返回值：用户识别码。

• getutent()函数

  struct utmp * getutent(void);

  函数说明：getutent()用来从utmp文件(/var/run/utmp)中读取一项登录数据，该数据以utmp结构返回。第一次调用时会取得第一位用户数据，之后每调用一次就会返回下一项数据，直到已无任何数据时返回NULL。

  返回值：返回utmp结构数据，如果返回NULL，则表示已无数据，或有错误发生。

  注意：getutent()在第一次调用时会打开utmp文件，读取数据完毕后可使用endutent()来关闭utmp。

• getutid()函数

  struct utmp * getutid(struct utmp *ut);

  函数说明：getutid()用来从目前utmp文件的读写位置注意往后搜索参数ut指定的记录。

  返回值：返回utmp数据结构，如果返回NULL，则表示已无数据，或有错误发生。

• getutline()函数

  struct utmp * getutline(struct utmp *ut);

  函数说明：getutline()用来从目前utmp文件的读写位置逐一往后搜索ut_type为USER_PROCESS或LOGIN_PROCESS的记录，而且ut_line和ut->ut_line相符。找到相符的记录便将该数据以utmp结构返回。

  返回值：返回utmp结构数据，如果返回NULL，则表示已无数据，或有错误发生。

• initgroups()函数

  int initgroups(const char *user, gid_t group);

  函数说明：initgroups()用来从组文件(/etc/group)中读取一项数据，若该组数据的成员中有参数user时，便将参数group组织识别码加入到此数据中。

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

• pututline()函数

  void pututline(struct utmp *ut);

  函数说明：pututline()用来将参数ut的utmp结构记录到utmp文件中。此函数会先用getutid()来取得正确的写入位置，如果没有找到相符的记录则会加入到utmp文件尾。

  注意：需要有写入/var/run/utmp的权限。

• seteuid()函数

  int seteuid(uid_t euid);

  函数说明：seteuid()用来重新设置执行目前进程的有效用户识别码。在Linux下，seteuid(euid)相当于serreuid(-1,euid)。

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

• setfsgid()函数

  int setfsgid(uid_t fsgid);

  函数说明：setfsgid()用来重新设置目前进程的文件系统的组识别码。一般情况下，文件系统的组识别码(fsgid)与有效的组识别码(egid)是相同的。如果是超级用户调用此函数，参数fsgid可以为任何值，否则参数fsgid必须为real/effective/saved的组识别码之一。

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

  注意：此函数为Linux特有函数。

• setfsuid()函数

  int setfsuid(uid_t fsuid);

  函数说明：setfsuid()用来重新设置目前进程的文件系统的用户识别码。一般情况下，文件系统的用户识别码(fsuid)与有效的用户识别码(euid)是相同的。如果是超级用户调用此函数，参数fsuid可以为任何值，否则参数fsuid必须为real/effective/saved的用户识别码之一。

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

  注意：此函数为Linux特有函数。

• setgid()函数

  int setgid(gid_t gid);

  函数说明：setgid()用来将目前进程的真实组识别码（real gid）设成参数gid值。如果是以超级用户身份执行此调用，则real、effective与savedgid都会设成参数gid。

  返回值：设置成功则返回0，失败则返回-1，错误代码存于errno中。

  错误代码：EPERM为并非以超级用户身份调用，而且参数gid并非进程的effective gid或saved gid值之一。

• setgrent()函数

  void setgrent(void);

  函数说明：setgrent()用来将getgrent()的读写地址指回组文件开头。

• setgroups()函数

  int setgroups(size_t size, const gid_t *list);

  函数说明：setgroups()用来将list数组中所标明的组加入到目前进程的组设置中。参数size为list()的gid_t数目，最大组为NGROUP(32)。

  返回值：设置成功则返回0，如果错误则返回-1。

  错误代码：EFAULT为参数list数组地址不合法；EPERM为权限不足，必须是root权限；EINVAL为参数size大于NGROUP(32)。

• setpwent()函数

  void setpwent(void);

  函数说明：setpwent()用来经getpwent()的读写地址指回密码文件开头。

• setregid()函数

  int setregid(gid_t rgid, gid_t egid);

  函数说明：setregid()用来将参数rgid设为目前进程的真实组识别码，将参数egid设置为目前进程的有效组识别码。如果参数rgid或egid值为-1，则对应的识别码不会改变。

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

• setreuid()函数

  int setreuid(uid_t ruid, uid_t euid);

  函数说明：setreuid()用来将参数ruid设为目前进程的真实用户识别码，将参数euid设置为目前进程的有效用户识别码。如果参数ruid或euid值为-1，则对应的识别码不会改变。

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

• setuid()函数

  int setuid(uid_t uid);

  函数说明：setuid()用来重新设置执行目前进程的用户识别码。不过，要让此函数有作用，其有效的用户识别码必须为0（root）。在Linux下，当root使用setuid()来变换成其他用户识别码时，root权限会被抛弃，完全转换成该用户身份，即该进程往后将不再具有可setuid()的权利，如果只是向暂时抛弃root权限，稍后想重新取回权限，则必须使用seteuid()。

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

  注意：一般在编写具setuid root的程序时，为减少此类程序带来的系统安全风险，在使用root权限后建议马上执行setuid(getuid())来抛弃root权限。此外，进程uid和euid不一致时Linux系统将不会产生core dump。

• setutent()函数

  void setutent(void);

  函数说明：setutent()用来将getutent()的读写地址指回utmp文件开头。

  注意：参考setpwent()或setgrent()。

• utmpname()函数

  void utmpname(const char *file);

  函数说明：utmpname()用来设置utmp文件的路径，以提供utmp相关函数的存取路径。如果没有使用utmpname()则默认utmp文件路径为/var/rum/utmp。

• close()函数

  int close(int fd);

  函数说明：当使用完文件后若不再需要则可使用close()关闭文件，close()会让数据写回磁盘，并释放该文件所占用的资源。参数fd为先前由open()或create()所返回的文件描述词。

  返回值：若文件顺利关闭则返回0，发生错误时返回-1。

  错误代码：EBADF参数fd非有效的文件描述词或该文件已关闭。

  注意：虽在进程结束时，系统会自动关闭已打开的文件，但仍建议自行关闭文件，并确实检查返回值。

• creat()函数

  int creat(const char *pathname, mode_tmode);

  函数说明：参数pathname指向欲建立的文件路径字符串；creat()相当于使用下列的调用方式调用open():open(const char *pathname, (O_CREATE|O_WRONLY|O_TRUNC));

  返回值：creat()会返回新的文件描述词，若有错误发生则会返回-1，并把错误代码设给errno。
  EEXIST参数：pathname所指的文件已存在；
  EACCESS参数：pathname所指定的文件不符合所要求测试的权限；
  EROFS：欲打开写入权限的文件存在于只读文件系统内；
  EFAULT参数：pathname指针超出可存取的内存空间；
  EINVAL参数：mode不正确；
  ENAMETOOLONG参数：pathname太长；
  ENOTDIR参数：pathname为一目录；
  ENOMEM参数：核心内存不足；
  ELOOP参数：pathname有过多的符号连接问题；
  EMFILE：已达到进程可同时打开的文件数上限；
  ENFILE：已达到系统可同时打开的文件数上限。

  注意：creat()无法建立特别的转置文件，如果需要请使用mknod()。

• dup()函数

  int dup(int oldfd);

  函数说明：dup()用来复制参数oldfd所指的文件描述词，并将它返回。此新的文件描述词和参数oldfd指的是同一个文件，共享所有的锁定、读写位置和各项权限或旗标。如当利用lseek()对某个文件描述词作用时，另一个文件描述词的读写位置也会随着改变。不过，文件描述词之间并不共享close-on-exec旗标。

  返回值：当复制成功时，则返回最小及尚未使用的文件描述词。若有错误则返回-1，errno会存放错误代码。

  错误代码：EBADF参数fd非有效的文件描述词，或该文件已关闭。

• dup2()函数

  int dup2(int oldfd, int newfd);

  函数说明：dup2()用来幅值参数oldfd所指的文件描述词，并将它拷贝至参数newfd后一块返回。若参数newfd为一已打开的文件描述词，则newfd所指的文件会先被关闭。dup2()所复制的文件描述词，与原来的文件描述词共享各种文件状态。

  返回值：但复制成功时，则返回最小及尚未使用的文件描述词。若有错误则返回-1，errno会存放错误代码。

  注意：dup2()相当于调用fcntl(oldfd,F_DUPED,newfd)。
  错误代码：EBADF参数fd非有效的文件描述词，或该文件已关闭。

• fcntl()函数

  int fcntl(int fd, int cmd);
  int fcntl(int fd, int cmd, long arg);
  int fcntl(int fd, int cmd, struct flock *lock);

  函数说明：fcntl()用来操作文件描述词的一些特性；参数fd代表欲设置的文件描述词；参数cmd代表欲操作的指令。有以下几种情况：
  FDUPFD用来查找大于或等于参数arg的最小且扔未使用的文件描述词，并且复制fd的文件描述词。执行成功则返回新复制的文件描述词。
  F_GETFD取得close-on-exec旗标。若此旗标的FD_CLOEXEC位为0，代表在调用exec()相关函数时文件将不会关闭。
  F_SETFD设置close-on-exec旗标，该旗标以参数arg的FD_CLOEXEC位决定。
  F_GETFL取得文件描述词状态旗标，此旗标为open()的参数flags。
  F_SETFL设置文件描述词状态旗标，参数arg为新旗标，但只允许O_APPEND、O_NONBLOCK和O_ASYNC位的改变，其他位的改变将不受影响。
  F_GETLK取得文件锁定的状态。
  F_SETLK设置文件锁定的状态。此时flcok结构的l_type值必须是F_RDLCK、F_WRLCK或F_UNLCK。如果无法建立锁定，则返回-1，错误代码为EACCES或EAGAIN。
  F_SETLKW同F_SETLK作用相同，但是无法建立锁定时，此调用会一直等到锁定动作成功为止。若在等待锁定的过程中被信号中断时，会立即返回-1，错误代码为EINTR。参数lock指针为flock结构指针。

  返回值：成功则返回0，若有错误则返回-1，错误原因存于errno。

• flock()函数

  int flock(int fd, int operation);

  函数说明：flock()会依参数operation所指定的方式对参数fd所指的文件做各种锁定或解除锁定的动作。此函数只能锁定整个文件，无法锁定文件的某一区域。

  参数operation有下列四种情况：
  LOCK_SH建立共享锁定。多个进程可同时对同一个文件作共享锁定。
  LOCK_EX建立互斥锁定。一个文件同时只有一个互斥锁定。
  LOCK_UN解除文件锁定状态。
  LOCK_NB无法建立锁定时，此操作可不被阻断，马上返回进程。通常与LOCK_SH或LOCK_EX做OR(|)组合。

  注意：单一文件无法同时建立共享锁定和互斥锁定，而当使用dup()或fork()时文件描述词不会继承此种锁定。

  返回值：返回0，表示成功，如有错误则返回-1，错误代码存于errno。

• fsync()函数

  int fsync(int fd);

  函数说明：fsync()负责将参数fd所指的文件数据，由系统缓冲区写回磁盘，以确保数据同步。

  返回值：成功则返回0，失败返回-1，errno为错误代码。

• lseek()函数

  off_t lseek(int fildes, off_t offset, int whence);

  函数说明：每一个已打开的文件都有一个读写位置，当打开文件时通常其读写位置是指向文件开头，若是以附件的方式打开文件（如O_APPEND），则读写位置会指向文件尾。当read()或write()时，读写位置会随之增加，lseek()便是用来控制该文件的读写位置。参数fildes为已打开的文件描述词，参数offset为根据参数whence来移动读写位置的位移数。

  参数whence为下列其中一种：
  SEEK_SET：参数offset即为新的读写位置。
  SEEK_CUR：以目前的读写位置往后增加offset个位移量。
  SEEK_END：将读写位置指向文件尾后再增加offset个位移量。当whence值为SEEK_CUR或SEEK_END时，offset允许负值的出现。

  下列是较特别的使用方式：
  欲将读写位置移到文件开头时：lseek(int fildes, 0, SEEK_SET);
  欲将读写位置移到文件尾使时：lseek(int fildes, 0, SEEK_END);
  想要取得目前文件位置时：lseek(int fildes, 0, SEEK_CUR);

  返回值：当调用成功时，则返回目前的读写位置，也就是距离文件开头多少个字节。若有错误则返回-1，errno会存放错误代码。

  附件说明：Linux系统不允许lseek()对tty装置作用，此项动作会令lseek()返回ESPIPE。

• mkstemp()函数

  int mkstemp(char *template);

  函数说明：mkstemp()用来建立唯一的临时文件。参数template所指的文件名称字符串中最后六个字符必须是**。mkstemp()会以可读写模式和0600权限来打开该文件，如果该文件不存在则会建立该文件。打开该文件后其文件描述词会返回。文件顺利打开后返回可读写的文件描述词。如果文件打开失败则返回NULL，并把错误代码存在errno中。

  错误代码：EINVAL参数template字符串最后六个字符非**。EEXIST无法建立临时文件。

  注意：参数template所指的文件名称字符串必须声明为数组，如char template[] = “template-XXXXXX”;千万不能使用char *template = “template-XXXXXX”。

• open()函数

  int open(const char *pathname, int flags);
  int open(const char *pathname, int flags, mode_t mode);

  函数说明：参数pathname指向欲打开的文件路径字符串。下列是参数flags所能使用的旗标：
  O_RDONLY以只读方式打开文件。
  O_WRONLY以只写方式打开文件。
  O_RDWR以可读可写方式打开文件。上述三种旗标是互斥的，及不可同时使用，但可以下列旗标利用OR(|)运算符组合。
  O_CREAT欲打开的文件不存在则自动建立该文件。
  O_EXCL如果O_CREAT也被设置，此指令会去检查文件是否存在。文件若不存在则建立该文件，否则将导致打开文件错误。此外，若O_CREAT与O_EXCL同时设置，并且欲打开的文件为符号链接，则会打开文件失败。
  O_NOCTTY如果欲打开的文件为终端机设备时，则不会将该终端机当成进程控制终端机。
  O_TRUNC若文件存在并且以可写的方式打开时，此旗标会令文件长度清为0，而原来存于该文件的资料也会消失。
  O_APPEND当读写文件时会从文件尾开始移动，也就是所写入的数据会以附件的方式加入到文件后面。
  O_NONBLOCK以不可阻断的方式打开文件，也就是无论有无数据读取或等待，都会立即返回进程之中。
  O_NDELAY同O_NONBLOCK。
  O_SYNC以同步的方式打开文件。
  O_NOFOLLOW如果参数pathname所指的文件为一符号链接，则会令打开文件失败。
  O_DIRECTORY如果参数pathname所指的文件并非为一目录，则会令打开文件失败。

  参数mode 则有下列数种组合, 只有在建立新文件时才会生效, 此外真正建文件时的权限会受到umask 值所影响, 因此该文件权限应该为 (mode-umaks).
  S_IRWXU，00700 权限, 代表该文件所有者具有可读、可写及可执行的权限.
  S_IRUSR 或S_IREAD, 00400 权限, 代表该文件所有者具有可读取的权限.
  S_IWUSR 或S_IWRITE, 00200 权限, 代表该文件所有者具有可写入的权限.
  S_IXUSR 或S_IEXEC, 00100 权限, 代表该文件所有者具有可执行的权限.
  S_IRWXG 00070 权限, 代表该文件用户组具有可读、可写及可执行的权限.
  S_IRGRP 00040 权限, 代表该文件用户组具有可读的权限.
  S_IWGRP 00020 权限, 代表该文件用户组具有可写入的权限.
  S_IXGRP 00010 权限, 代表该文件用户组具有可执行的权限.
  S_IRWXO 00007 权限, 代表其他用户具有可读、可写及可执行的权限.
  S_IROTH 00004 权限, 代表其他用户具有可读的权限
  S_IWOTH 00002 权限, 代表其他用户具有可写入的权限.
  S_IXOTH 00001 权限, 代表其他用户具有可执行的权限.

  返回值：若所有欲核查的权限都通过了检查，则返回0值，表示成功，只有有一个权限被禁止，则返回-1。

  错误代码：

  EEXIST 参数pathname 所指的文件已存在, 却使用了O_CREAT 和O_EXCL 旗标.
  EACCESS 参数pathname 所指的文件不符合所要求测试的权限.
  EROFS 欲测试写入权限的文件存在于只读文件系统内.
  EFAULT 参数pathname 指针超出可存取内存空间.
  EINVAL 参数mode 不正确.
  ENAMETOOLONG 参数 pathname 太长.
  ENOTDIR 参数pathname 不是目录.
  ENOMEM 核心内存不足.
  ELOOP 参数pathname 有过多符号连接问题.
  EIO I/O 存取错误.

  注意：使用access()作用户认证方面的判断要特别小心，如在access()后再做open()空文件可能会造成系统安全上的问题。

• read()函数

  ssize_t read(int fd, void *buf, size_t count);

  函数说明：read()会把参数fd所指的文件传送count个字节到buf指针所指的内存中。若参数count为0，则read()不会有作用并返回0。返回值为实际读取到的字节数，如果返回0，表示已达到文件尾或是无可读取的数据，此外文件读写位置会随读取到的字节移动。

  注意：如果顺利read()会返回实际读到的字节数，最后能将返回值与参数count作比较，若返回的字节数比要求读取的字节数少，则有可能读到了文件尾、从管道（pipe）或终端机读被信号终端的读取。

  返回值：当有错误发生时，则返回-1，错误代码存入errno中，而文件读写位置则无法预测。

  错误代码：
  EINTR 此调用被信号所中断
  EAGAIN 当使用不可阻断I/O时(O_NONBLOCK)，若无数据可读取则返回此值
  EBADF 参数fd非有效的文件描述词，或该文件已被关闭

• sync()函数

  int sync(void);

  函数说明：sync()负责将系统缓冲区数据写回磁盘，以确保数据同步。

  返回值：返回0。

• write()函数

  ssize_t write(int fd, const void *buf, size_t count);

  函数说明：write()会把参数buf所指的内存写入count个字节到参数fd所指的文件内。当然，文件读取位置也会随之移动。

  返回值：如果顺利，write()会返回实际写入的字节数。当有错误发生时，则返回-1，错误代码存入errno中。

  错误代码：
  EINTR 此调用被信号所中断
  EAGAIN 的那个使用不可阻断I/O时(O_NONBLOCK)，若无数据可读取则返回此值
  EADF 参数fd非有效的文件描述词，或该文件已关闭。

• clearerr()函数

  void clearerr(FILE *stream);

  函数说明：clearerr()清除参数stream指定的文件流所使用的错误旗标。

• fclose()函数

  int fclose(FILE *stream);

  函数说明：fclose()用来关闭先前fopen()打开的文件。此动作会让缓冲区内的数据写入文件中，并释放系统所提供的文件资源。

  返回值：若文件动作成功，则返回0，有错误发生时，则返回EOF并把错误代码存到errno。

  错误代码：
  EBADF 表示参数stream非已打开的文件。

• fdopen()函数

  FILE *fdopen(int fildes, const char *mode);

  函数说明：fdopen()会将参数fildes的文件描述词，转换为对应的文件指针后返回。参数mode字符串则代表着文件指针的流形态，此形态必须和原先文件描述词读写模式相同。

  返回值:转换成功时，返回指向该流的文件指针。失败则返回NULL，并把错误代码存在errno中。

• feof()函数

  int feof(FILE *stream);

  函数说明：feof()用来侦测是否读取到了文件尾，尾数stream为fopen()所返回之文件指针。如果已到文件尾则返回非零值，其他情况返回0。

  返回值：返回非零值，则表示已到达文件尾。

• fflush()函数

  int fflush(FILE *stream);

  函数说明：fflush()会强迫将缓冲区内的数据写回参数stream指定的文件中。如果参数stream为NULL，fflush()会将所有打开的文件数据更新。

  返回值：成功返回0，失败返回EOF，错误代码存于errno中。

  错误代码：EBADF 参数stream指定的文件未被打开，或打开状态为只读。

• fgetc()函数

  int fgetc(FILE *stream);

  函数说明：fgetc()从参数stream所指的文件中读取一个字符。若读到文件尾而无数据时便返回EOF。

  返回值：getc()会返回读取到的字符，若返回EOF，则表示到了文件尾。

• fgets()函数

  char *fgets(char *s, int size, FILE *stream);

  函数说明：fgets()用来从参数stream所指的文件内读入字符并存到参数s所指的内存空间，直到出现换行字符、读到文件尾或是已读了size-1个字符为止，最后会加上NULL作为字符串结束。

  返回值：gets()若成功，返回s指针，返回NULL则表示有错误发生。

• fileno()函数

  int fileno(FILE *stream);

  函数说明：fileno()用来取得参数stream指定的文件流所使用的文件描述词。

  返回值：返回文件描述词。

• fputc()函数

  int fputc(int c, FILE *stream);

  函数说明：fputc会将参数c转为unsigned char后写入参数stream指定的文件中。

  返回值：fputc()会返回写入成功的字符，即参数c。若返回EOF则代表写入失败。

• fputs()函数

  int fputs(const char *s, FILE *stream);

  函数说明：fputs()用来将参数s所指的字符串写入到参数stream所指的文件内。

  返回值：若成功，则返回写出的字符个数，返回EOF则表示有错误发生。

• fread()函数

  size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream);

  函数说明：fread()用来从文件流中读取数据。参数stream为已打开的文件指针，参数ptr指向欲存放读取进来的数据空间，读取的字符数以参数size *nmemb来决定。fread()会返回实际读取到的nmemb数目，如果此值比参数nmemb来得小，则代表可能读取到了文件的尾或有错误发生，这是必须用feof()或ferror()来决定发生什么情况。

  返回值：返回实际读取到的nmemb数目。

• freopen()函数

  FILE *freopen(const char *path, const char *mode, FILE *stream);

  函数说明：参数path字符串包含欲打开的文件路径和文件名；参数stream为已打开的文件指针。freopen()会将原stream所打开的文件流关闭，然后打开参数path的文件。

  返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败，则返回NULL，并把错误代码存在errno中。

• fseek()函数

  int fseek(FILE *stream, long offset, int whence);

  函数说明：fseek()用来移动文件流的读写位置。参数stream为已打开的文件指针；参数offset为根据参数whence来移动读写位置的位移数。参数whence为下列其中一种:SEEK_SET：从距文件开头offset位移量为新的读写位置；SEEK_CUR：以目前的读写位置往后增加offset个位移量；SEEK_END：将读写位置指向文件尾后再增加offset个位移量，当whence值为SEEK_CUR或SEEK_END时,参数offset 允许负值的出现.

  下列是较特别的使用方式：
  欲将读写位置移动到文件开头时:fseek(FILE *stream, 0, SEEK_SET);
  欲将读写位置移动到文件尾时:fseek(FILE *stream, 0, 0SEEK_END);

  返回值：当调用成功时则返回0, 若有错误则返回-1, errno 会存放错误代码.

  注意：fseek()不像lseek()会返回读写位置, 因此必须使用ftell()来取得目前读写的位置

• ftell()函数

  long ftell(FILE *stream);

  函数说明：ftell()用来取得文件流目前的读写位置。参数stream为已打开的文件指针。

  返回值：当调用成功时，则返回目前的读写位置，若有错误则返回-1，errno会存放错误代码。

  错误代码：EBADF 参数stream无效或可移动读写位置的文件流。

• fwrite()函数

  size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream);

  函数说明：fwrite()用来将数据写入文件流中。参数stream为已打开的文件指针，参数ptr指向欲写入的数据地址，总共写入的字符数以参数size *nmemb来决定。fwrite()会返回实际写入的nmemb数目。

  返回值：返回实际写入的nmemb数目。

• mktemp()函数

  char *mktemp(char *template);

  函数说明：mktemp()用来产生唯一的临时文件名。参数template所指的文件名称字符串中最后六个字符必须是XXXXXX，产生后的文件名会借字符串指针返回。

  返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败，则返回NULL，并把错误代码存在errno中。

• setbuffer()函数

  void setbuffer(FILE *stream, char *buf, size_t size);

  函数说明：在打开文件流后，读取内容之前，调用setbuffer()可用来设置文件流的缓冲区。参数stream为指定的文件流，参数buf指向自定的缓冲区起始位置，参数size为缓冲区大小。

• setlinebuf()函数

  void setlinebuf(FILE *stream);

  函数说明：setlinebuf()用来设置文件流以换行为依据的的无缓冲IO。相当于调用setvbuf(stream, (char *)NULL, _IOLBF, 0)。

参数文献

http://c.biancheng.net/cpp/u/hs6/