Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (r) rename(2)
NAME
rename - Renames a file or directory
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: system library
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series and J-series OSS processes: implicit libraries
DESCRIPTION
The C run-time library supports two variants of the rename() function: rename_oss() and
rename_guardian(). The variants support the unique file-naming conventions and structures of
the OSS and Guardian file systems, respectively.
The header file maps calls to rename() to the variant that matches the target compilation
environment. The target environment is set with the systype pragma.
Explicit calls to the rename_oss() and rename_guardian() variants in source code are made
only when the behavior of one environment is desired from the other environment.
For a description of the OSS rename() function and the rename_oss() function, see the
rename_oss(2) reference page. For a description of the Guardian rename() function and the
rename_guardian() function, see the rename_guardian(2) reference page.
NOTES
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit OSS applications.
527186-023 Hewlett-Packard Company 6−43