lib/libsys/open.2

33 .Nd open or create a file for reading, writing or executing
43 The file name specified by
49 and the file descriptor returned to the calling process.
52 argument may indicate the file is to be
62 and the file is created with mode
87 the file to be opened is determined relative to the directory
88 associated with the file descriptor
131 must be strictly relative to a file descriptor
180 set file pointer to the end of the file before each write
182 create file if it does not exist
188 is set and the file exists
209 error if file is not a directory
211 automatically close file on
214 automatically close file on any child process created with
217 verify the contents of the file with
228 open file referenced by
243 Opening a file with
245 set causes each write on the resulting file descriptor
246 to be appended to the end of the file.
251 file exists, the file is truncated to zero length.
255 is set, but file already exists,
264 In all other cases, the file is created
267 of the file mode
272 This argument does not affect whether the file is opened
274 The open' request for a lock on the file, created with
277 provided that the underlying file system supports locking;
314 synchronously written to disk, but changes to metadata such as file access and
319 is used in the mask and the target file passed to
325 When opening a file, a lock with
343 may be used to ensure the OS does not assign this file as the
369 may be used to ensure the resulting file descriptor refers to a
379 flag for the newly returned file descriptor.
384 flag for the newly returned file descriptor.
385 The file will be closed on any child process created with
403 may be used to indicate to the kernel that the contents of the file should
423 The returned file descriptor
439 returns a file descriptor that can be used as the first argument for
443 taking a file descriptor argument, like
446 The other functionality of the returned file descriptor is limited to
485 and any other that operate on file and not on file descriptor (except
489 A file descriptor created with the
491 flag can be opened as a normal (operable) file descriptor by
501 Such an open behaves as if the current path of the file referenced by
510 Conversely, a file descriptor
512 referencing a filesystem file can be converted to the
519 returns a non-negative integer, termed a file descriptor.
521 The file descriptor value returned is the lowest numbered descriptor
523 The file pointer used to mark the current position within the
524 file is set to the beginning of the file.
537 When a new file is created, it is assigned the group of the directory
558 argument is for a file object,
559 a named attribute for the file object
560 is opened and not the file object itself.
583 then the named attribute directory for the file object is opened.
588 The system imposes a limit on the number of file descriptors
598 return a non-negative integer, termed a file descriptor.
603 The named file is opened unless:
612 is not set and the named file does not exist.
626 the file does not exist,
631 is specified, the file does not exist, and the directory in which it is to be
636 The named file has its immutable flag set and the file is to be modified.
638 The named file has its append-only flag set, the file is to be modified, and
646 The named file is a directory, and the arguments specify
649 The named file is a directory, and the flags specified
654 The named file resides on a read-only file system,
655 and the file is to be modified.
658 is specified and the named file would reside on a read-only file system.
660 The process has already reached its limit for open file descriptors.
662 The system file table is full.
671 The named file is a character special or block
672 special file, and the device associated with this special file
676 is set, the named file is a fifo,
678 is set, and no process has the file open for reading.
687 is specified but the underlying file system does not support locking.
689 The named file is a special file mounted through a file system that
697 is specified and the file is locked.
701 the file does not exist,
702 and the directory in which the entry for the new file is being placed
703 cannot be extended because there is no space left on the file
708 the file does not exist,
709 and there are no free inodes on the file system on which the
710 file is being created.
714 the file does not exist,
715 and the directory in which the entry for the new file
717 user's quota of disk blocks on the file system
722 the file does not exist,
723 and the user's quota of inodes on the file system on
724 which the file is being created has been exhausted.
730 Corrupted data was detected while reading from the file system.
732 The file is a pure procedure (shared text) file that is being
745 were specified and the file exists.
764 argument is invalid on the file system on which the file is being created.
773 nor a valid file descriptor open for searching.
781 nor a file descriptor associated with a directory.
784 is specified and the file is not a directory.
821 has been specified and the file object is not a named attribute