Open System Services System Calls Reference Manual (G06.28+)

System Functions (r) rename_oss(2)
To use the rename_oss() and rename_guardian() functions, specify the
_TANDEM_SOURCE feature-test macro.
RETURN VALUES
Upon successful completion, the rename() function returns the value 0 (zero). Otherwise, the
value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the rename() function sets errno to the corresponding
value. The file or directory name remains unchanged.
[EACCES] One of the following conditions exists:
• A component of either pathname denies search permission.
• One of the directories containing from or to denies write permission.
• The S_ISVTX flag is set on the directory containing the file referred to
by the from parameter. However, the calling process is not any of the
following:
— The file owner
— The directory owner
— A process with appropriate privileges
• The S_ISVTX flag is set on the directory containing an existing file
referred to by the to parameter. However, the calling process is not any
of the following:
— The file owner
— The directory owner
— A process with appropriate privileges
[EBUSY] One of the following conditions occurred:
• The to parameter specifies a directory that exists and is one of the fol-
lowing:
— /G or /E
— A Guardian disk volume or process name in /G (a file with an
OSS pathname of the form /G/vol or /G/process)
— The root directory of a fileset
— The /dev directory or the lost+found file for a fileset (for exam-
ple, /usr/lost+found, where /usr is the mount point for a fileset)
• The from parameter specifies one of the following:
— /G or /E
527186-005 Hewlett-Packard Company 6−31