[C++知识库]C Library User 手册(10)

10.3 errno.h

包含标准头文件 <errno.h> 以测试某些库函数存储在 errno 中的值。 在程序启动时，存储的值为零。 库函数只存储大于零的值。 任何库函数都可以更改存储的值，但仅在此处记录明确??要求库函数存储值的情况。

要测试库函数是否在 errno 中存储了值，程序应该在调用库函数之前立即将值存储在 errno 中。

#define EDOM <#if expression>
#define EILSEQ <#if expression> [added with Amendment 1]
#define ERANGE <#if expression>
#define errno <int modifiable lvalue>

实现可以在此标准标头中定义其他宏，你可以测试它们与存储的值是否相等。 所有这些附加宏的名称都以 E 开头。例如，以下宏是由 Posix 添加的：

#define E2BIG [argument list too long]
#define EACCES [process lacks access permission]
#define EAGAIN [resource temporarily unavailable]
#define EBADF [bad file descriptor]
#define EBADMSG [bad message]
#define EBUSY [resource is busy]
#define ECANCELED [operation canceled]
#define ECHILD [no child process present]
#define EDEADLK [resource deadlock was avoided]
#define EEXIST [file already exists]
#define EFAULT [bad memory address]
#define EFBIG [file would become too big]
#define EINPROGRESS [asynchronous operation not completed]
#define EINTR [operation interrupted by a signal]
#define EINVAL [invalid argument]
#define EIO [input/output error]
#define EISDIR [can't write to a directory]
#define EMFILE [process has too many files open]
#define EMLINK [too many links to a file]
#define EMSGSIZE [bad message buffer size]
#define ENAMETOOLONG [file name too long]
#define ENFILE [system has too many files open]
#define ENODEV [invalid device operation]
#define ENOENT [bad file or directory name]
#define ENOEXEC [can't execute file]
#define ENOLCK [too many locks on a file or record]
#define ENOMEM [insufficient memory]
#define ENOSPC [insufficient space on a device]
#define ENOSYS [unimplemented function]
#define ENOTDIR [invalid directory name]
#define ENOTEMPTY [directory not empty]
#define ENOTSUP [unsupported feature[
#define ENOTTY [bad I/O control operation]
#define ENXIO [bad device specifier]
#define EPERM [process lacks permission]
#define EPIPE [write to a broken pipe]
#define EROFS [write to a read-only file system]
#define ESPIPE [seek on a pipe]
#define ESRCH [process search failed]
#define ETIMEDOUT [time limit expired]
#define EXDEV [link across file systems]

10.3.1 EDOM

#define EDOM <#if expression>
宏产生存储在 errno 中的域错误值。

10.3.2 EILSEQ

#define EILSEQ <#if expression> [added with Amendment 1]

该宏在无效的多字节序列上产生存储在 errno 中的值。

10.3.3 ERANGE

#define ERANGE <#if expression>
宏产生范围错误时存储在 errno 中的值。

10.3.4 errno

#define errno <int modifiable lvalue>

该宏指定一个对象，该对象在某些库错误时分配的值大于零。

10.4 fcntl.h

该文件包含文件描述符控制功能。
int fcntl(int fd, int cmd, ...); [POSIX]

10.4.1 fcntl

int fcntl(int fd, int cmd, ...); [POSIX]

fcntl 提供对描述符的控制。 参数 fd 是由 cmd 操作的描述符，如下所述。 第三个参数称为 arg 并且在技术上是指向 void 的指针，但它被某些命令解释为 int 并被其他命令忽略。

命令是：

F_GETFL 和 F_SETFL 标志的标志如下：

有几个命令可用于执行建议文件锁定； 它们都在以下结构上运行：

struct flock {
    off_t l_start; /* starting offset */
    off_t l_len; /* len = 0 means until end of file */
    pid_t l_pid; /* lock owner */
    short l_type; /* lock type: read/write, etc. */
    short l_whence; /* type of l_start */
};

可用于寻访记录锁定的命令如下：

当在文件的某个段上设置共享锁时，其他进程可以在该段或其一部分上设置共享锁。 共享锁可防止任何其他进程在受保护区域的任何部分设置排他锁。 如果文件描述符未以读取访问权限打开，则共享锁请求失败。

排他锁可防止任何其他进程在受保护区域的任何部分设置共享锁或排他锁。 如果文件不是以写访问权限打开的，则对独占锁的请求将失败。

l_whence 的值是 SEEK_SET、SEEK_CUR 或 SEEK_END，表示相对偏移量 l_start 字节将分别从文件开头、当前位置或文件结尾开始测量。 l_len 的值是要锁定的连续字节数。 如果 l_len 为负，则结果未定义。 l_pid 字段仅与 F_GETLK 一起使用，以返回持有阻塞锁的进程的进程 ID。 F_GETLK 请求成功后，l_whence 的值为 SEEK_SET。

锁可以开始并延伸到文件的当前结尾之外，但不能在文件开头之前开始或延伸。 如果 l_len 设置为零，则将锁设置为扩展到该文件的文件偏移的最大可能值。 如果 l_whence 和 l_start 指向文件的开头，并且 l_len 为零，则整个文件被锁定。 如果应用程序只希望对整个文件进行锁定，flock 系统调用会更有效。

文件中的每个字节最多设置一种类型的锁。 在从 F_SETLK 或 F_SETLKW 请求成功返回之前，当调用进程在请求指定的区域中先前存在对字节的锁定时，指定区域中每个字节的先前锁定类型被新的锁定类型替换。 如上面在共享锁和排他锁的描述中所指定的，当另一个进程在指定区域中的字节上存在现有锁并且任何这些锁的类型与要求。

这个接口完全遵循 AT&T System V UNIX 和 IEEE Std 的愚蠢语义。 1003.1-1988 (``POSIX.1’’) 要求当该文件的任何文件描述符被该进程关闭时，删除与给定进程的文件关联的所有锁。 这种语义意味着应用程序必须知道子程序库可以访问的任何文件。 例如，如果更新密码文件的应用程序在进行更新时锁定了密码文件数据库，然后调用 getpwnam 检索记录，则由于 getpwnam 打开、读取和关闭密码数据库，锁定将丢失。 数据库关闭将释放进程与数据库关联的所有锁，即使库例程从未请求数据库上的锁。 这个接口的另一个小的语义问题是锁不会被使用 fork 函数创建的子进程继承。 flock 接口具有更合理的最后关闭语义，并允许子进程继承锁。 对于希望在使用库例程时确保其锁的完整性或希望将锁传递给其子级的应用程序，建议调用flock。 请注意，flock 和 fcntl 锁可以安全地同时使用。

当进程终止时，与给定进程的文件关联的所有锁都将被删除。

如果控制锁定区域的进程通过尝试锁定另一个进程的锁定区域而进入睡眠状态，则可能发生死锁。 此实现检测到在锁定区域解锁之前休眠会导致死锁并因 EDEADLK 错误而失败。

成功完成后，返回值取决于 cmd 如下：

否则，返回值 -1 并设置 errno 以指示错误。