open ， openat ， openx ， openxat ， open64， open64at， open64x， open64xat， creat 或 creat64 子例程

用途

打开文件以进行读取或写入。

语法

#include <fcntl.h>

int open (Path, OFlag [, Mode])
const char *Path;
int OFlag;
mode_t Mode;

int openat (DirFileDescriptor, Path, OFlag [, Mode])
int DirFileDescriptor;
const char *Path;
int OFlag;
mode_t Mode;

int openx (Path, OFlag, Mode, Extension)
const char *Path;
int OFlag;
mode_t Mode;
long Extension;

int openxat (DirFileDescriptor, Path, OFlag, Mode, Extension)
int DirFileDescriptor;
const char * Path;
int OFlag;
mode_t Mode;
long Extension;

int creat (Path, Mode)
const char *Path;
mode_t Mode;

int open64 (Path, OFlag [, Mode])
const char *Path;
int OFlag;
mode_t Mode;

int open64at (DirFileDescriptor, Path, 
OFlag [, Mode])
int DirFileDescriptor;
const char * Path;
int OFlag;
mode_t Mode;

int creat64 (Path, Mode)
const char *Path;
mode_t Mode;

int open64x (Path, OFlag, Mode, Extension)
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

int open64xat (DirFileDescriptor, Path, OFlag, Mode, Extension)
int DirFileDescriptor;
char *Path;
int64_t OFlag;
mode_t Mode;
ext_t Extension;

描述

如果DirFileDescriptor参数为AT_FDCWD，或者Path参数为绝对路径名，则 "openat子程序等同于 "open子程序。 如果DirFileDescriptor是打开目录的有效文件描述符，且Path是相对路径名，则Path将被视为相对于与DirFileDescriptor参数关联的目录，而不是当前工作目录。 同样， openxat， open64at或 open64xat 子例程分别与 openx， open64或 open64x 子例程等效，其方式与 openat 和 open相同。

open， openx和 creat 子例程在 Path 参数指定的文件与文件描述符之间建立连接。 打开的文件描述符由后续 I/O 子例程 (例如 read 和 write) 用于访问该文件。

openx 子例程与 open 子例程相同，添加了供设备驱动程序使用的 Extension 参数。 creat 子例程等同于设置了 O_WRONLY， O_CREAT和 O_TRUNC 标志的 open 子例程。

返回的文件描述符是先前未对该进程打开的最低文件描述符。 任何进程都不能同时打开超过 OPEN_MAX 个文件描述符。

文件偏移量 (标记文件中的当前位置) 被设置为文件的开头。 新的文件描述符设置为在 exec 子例程之间保持打开状态。

open64 和 creat64 子例程等同于 open 和 creat 子例程，只是在与返回的文件描述符相关联的打开文件描述中设置了 O_LARGEFILE 标志。 此标志允许访问大于 OFF_MAX 的文件。 如果调用者尝试打开大于 OFF_MAX 且未设置 O_LARGEFILE 的文件，那么打开将失败，并且 errno 将设置为 EOVERFLOW。

在启用了大文件的编程环境中， open 将重新定义为 open64 ， creat 将重新定义为 creat64。

open64x 子例程在加密文件系统 (EFS) 中创建和访问加密文件。 open64x 子例程类似于 openx 子例程，通过修改 OFlag 参数，将其更新为 64 位数量。

如果 "openat、"openxat、"open64at"或 "open64xat"子程序中的DirFileDescriptor参数在打开时未使用O_SEARCH打开标志，则该子程序会通过使用目录的当前权限来检查是否允许对该目录进行目录搜索。 如果该目录是使用 O_SEARCH 打开标志打开的，那么子例程不会对该目录执行检查。

参数

返回值

在成功完成时，将返回文件描述符 (非负整数)。 否则，返回值为-1，不创建或修改任何文件，并设置全局变量 "errno以指示错误。

错误代码

open，openat openx， openxat， open64， open64at， open64x， open64xat和 creat 子例程不成功，如果满足以下一个或多个条件，那么不会打开指定的文件:

如果下列其中一个子例程为 true ，那么 open， openx， open64x和 creat 子例程将失败:

openat， openxat， open64at和 open64xat 子例程不成功，如果满足以下一个或多个条件，那么不会打开指定的文件: