HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

o
open(2) open(2)
too are the same as their image on disk.
RETURN VALUE
open() returns the following values:
n Successful completion. n is a file descriptor for the opened file.
-1 Failure.
errno is set to indicate the error.
ERRORS
If
open() fails, errno is set to one of the following values.
[EACCES] oflag permission is denied for the named file.
[EACCES] A component of the path prefix denies search permission.
[EACCES] The file does not exist and the directory in which the file is to be created does not per-
mit writing.
[EACCES] O_TRUNC is specified and write permission is denied.
[EAGAIN] The file exists, enforcement mode file/record locking is set (see chmod(2)), there are
outstanding record locks on the file with the
flock(), lockf(),orfcntl() sys-
tem calls, and
O_TRUNC is set.
[EDQUOT] User’s disk quota block or inode limit has been reached for this file system.
[EEXIST] O_CREAT and O_EXCL are set and the named file exists.
[EFAULT] path points outside the allocated address space of the process.
[EINTR] A signal was caught during the open() system call, and the system call was not res-
tarted (see signal(5)).
[EINVAL] oflag specifies both O_WRONLY and
O_RDWR.
[EISDIR] The named file is a directory and oflag is write or read/write.
[ELOOP] Too many symbolic links are encountered in translating the path name.
[EMFILE] The maximum number of file descriptors allowed are currently open.
[ENAMETOOLONG]
The length of the specified path name exceeds
PATH_MAX bytes, or the length of a
component of the path name exceeds NAME_MAX bytes while _POSIX_NO_TRUNC
is
in effect.
[ENFILE] The system file table is full.
[ENODEV] The named file is a character special or block special file, and the driver associated
with this special file has not been configured into the kernel or the DLKM driver asso-
ciated with this special file failed to load.
[ENOENT] The named file does not exist (for example, path is null or a component of path does
not exist, or the file itself does not exist and
O_CREAT is not set).
[ENOTDIR] A component of the path prefix is not a directory.
[ENOTSUP] The last component of path is a sybolic link and O_NOFOLLOW was set.
[ENXIO] O_NDELAY is set, the named file is a FIFO, O_WRONLY is set, and no process has the
file open for reading.
[ENXIO] The named file is a character special or block special file, and the device associated
with this special file does not exist.
[ENOSPC] O_CREAT is specified, the file does not already exist, and the directory that would
contain the file cannot be extended.
[EOVERFLOW]
The named file is a regular file and the size of the file cannot be represented correctly
in an object of size off_t.
[EROFS] The named file resides on a read-only file system and oflag is write or read/write.
HP-UX 11i Version 3: February 2007 − 3 − Hewlett-Packard Company 257