Visit Our UNIX and Linux User Community

Linux and UNIX Man Pages

Test Your Knowledge in Computers #755
Difficulty: Medium
Flash memory is a type of EEPROM.
True or False?
Linux & Unix Commands - Search Man Pages

open(2) [hpux man page]

open(2) 							System Calls Manual							   open(2)

NAME
open() - open file for reading or writing SYNOPSIS
Remarks The ANSI C "" construct specifies a variable length argument list whose optional member is given in the associated comment DESCRIPTION
The system call opens a file descriptor for the named file and sets the file status flags according to the value of oflag. The path argument points to a path name naming a file, and must not exceed bytes in length. The oflag argument is a value that is the bitwise inclusive OR of flags listed in "Read-Write Flags," "General Flags," "Synchronized I/O Flags," and "Direct I/O Flags" below. The optional mode argument is only effective when the flag is specified. The file pointer used to mark the current position within the file is set to the beginning of the file. The new file descriptor is set to remain open across system calls. See fcntl(2). Read-Write Flags Exactly one of the or flags must be used in composing the value of oflag. If none or more than one is used, the behavior is undefined. Open for reading only. Open for writing only. Open for reading and writing. General Flags Several of the flags listed below can be changed with the system call while the file is open. See fcntl(2) and fcntl(5) for details. If set, the file offset is set to the end of the file prior to each write. If the file exists, this flag has no effect, except as noted under below. Otherwise, the owner ID of the file is set to the effective user ID of the process, the group ID of the file is set to the effective group ID of the process if the set-group-ID bit of the parent directory is not set, or to the group ID of the parent directory if the set-group-ID bit of the parent directory is set. The file access permission bits of the new file mode are set to the value of mode, modified as follows (see creat(2)): o For each bit set in the file mode creation mask of the process, the corresponding bit in the new file mode is cleared (see umask(2)). o The "save text image after execution" bit of the new file mode is cleared. See chmod(2). o On HFS file systems with access control lists, three base ACL entries are created corresponding to the file access permissions (see acl(5)). o On JFS file systems that support access control lists, optional ACL entries are created corresponding to the par- ent directory's default ACL entries (see aclv(5)). If and are set and the file exists, fails. This is a non-standard flag which may be used by 32-bit applications to access files larger than 2 GB. See creat64(2). This flag might affect subsequent reads and writes. See read(2) and write(2). When opening a FIFO with or set: If is set: A read-only returns without delay. A write-only returns an error if no process currently has the file open for reading. If is clear: A read-only does not return until a process opens the file for writing. A write-only does not return until a process opens the file for reading. When opening a file associated with a communication line: If is set: The returns without waiting for carrier. If is clear: The does not return until carrier is present. If set, and path identifies a terminal device, does not cause the terminal to become the controlling terminal for the process. If the last component of path refers to a symbolic link, the will fail. This is true regardless of whether the target of the link exists or not. NOTE: If the symbolic link in path is followed by a trailing '/', the link will be traversed, regardless of the set- ting of Same effect as for open(2), but slightly different effect in read(2) and write(2). If both and are specified, takes precedence. If the file exists, its length is truncated to 0 and the mode and owner are unchanged. Synchronized I/O Flags Together, the and flags constitute support for Synchronized I/O. These flags are ignored for files other than ordinary files and block special files on those systems that permit I/O to block special devices (see pathconf(2)). If both the and flags are set, the effect is as if only the flag was set. The flag is ignored if it is not set along with the or flag. If a file is opened with or that flag is set with the option of writes to that file by the process block until the data specified in the write request and all file attributes required to retrieve the data are written to the disk. File attributes that are not necessary for data retrieval (access time, modification time, status change time) are not necessarily written to the disk prior to return- ing to the calling process. Identical to with the addition that all file attributes changed by the write operation (including access time, modification time, and sta- tus change time) are also written to the disk prior to returning to the calling process. Identical to for file system writes. For file system reads, the calling process blocks until the data being read and all file attributes required to retrieve the data are the same as their image on disk. Writes pending on the data to be read are executed prior to returning to the call- ing process. Identical to for file system writes. Identical to for file system reads, with the addition that all file attributes changed by the read operation (including access time, modification time, and status change time) too are the same as their image on disk. RETURN VALUE
returns the following values: Successful completion. n is a file descriptor for the opened file. Failure. is set to indicate the error. ERRORS
If fails, 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 permit writing. [EACCES] 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 or system calls, and is set. [EDQUOT] User's disk quota block or inode limit has been reached for this file system. [EEXIST] and 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 system call, and the system call was not restarted (see signal(5)). [EINVAL] oflag specifies both and [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 bytes, or the length of a component of the path name exceeds bytes while 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 associated 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 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 was set. [ENXIO] is set, the named file is a FIFO, 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] 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 [EROFS] The named file resides on a read-only file system and oflag is write or read/write. [ETXTBSY] The file is open for execution and oflag is write or read/write. Normal executable files are only open for a short time when they start execution. Other executable file types can be kept open for a long time, or indefinitely under some circumstances. EXAMPLES
The following call to opens file for reading only and returns a file descriptor for For an example of reading from file see the read(2) manual entry. The following call to opens file for writing and returns a file descriptor for For an example of preallocating disk space for see the pre- alloc(2) manual entry. For an example of writing to see the write(2) manual entry. The following call opens file for synchronized I/O file integrity for reads and writes. AUTHOR
was developed by HP, AT&T, and the University of California, Berkeley. SEE ALSO
acl(2), chmod(2), close(2), creat(2), dup(2), fcntl(2), flock(2), lockf(2), lseek(2), creat64(2), pathconf(2), read(2), select(2), umask(2), write(2), setacl(2), acl(5), aclv(5), fcntl(5), privileges(5), signal(5), thread_safety(5), unistd(5). STANDARDS CONFORMANCE
open(2)

Featured Tech Videos