Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

remove_oss(3) OSS Library Calls Reference Manual
NAME
|
remove_oss - Removes a file (OSS remove( ) function) |
LIBRARY |
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL |
G-series native OSS processes: /G/system/sysnn/zcrtlsrl |
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL |
H-series OSS processes: /G/system/zdllnnn/zcrtldll |
SYNOPSIS
|
#include <stdio.h> |
int remove( |
const char *file_name); |
int remove_oss( |
const char *file_name); |
PARAMETERS
|
file_name ||
Points to the file to be removed. |
DESCRIPTION |
The remove() OSS function and remove_oss() function cause a file named by the string pointed |
to by file_name to be no longer accessible by that name. A subsequent attempt to open that file |
using that name will fail unless it is created anew. |
These functions are identical in the OSS environment. Unless otherwise noted, this reference |
page uses remove() to refer to both the remove() OSS function and remove_oss( ) function. |
If the file_name parameter refers to a directory, the call is equivalent to calling the rmdir() func- |
tion on that directory. |
If the file_name parameter refers to a file (not a directory), the call is equivalent to calling the |
unlink() function on that file. |
Interoperability Variants |
The C run-time library supports two variants of the remove() function: remove_oss( ) and |
remove_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 remove() to the variant that matches the target compilation |
environment. The target environment is set with the systype pragma. |
Explicit calls to the remove_oss() and remove_guardian() variants in source code are only |
made when the behavior of one environment is desired from the other environment. |
remove_oss() is functionally identical to the remove() function of the OSS environment. It is |
the same as setting systype oss at compile-time. systype oss is the default setting for c89 |
in the OSS environment and on UNIX workstations. |
remove_guardian() is functionally identical to the remove() function of the Guardian environ- |
ment. It is the same as setting systype guardian at compile-time. systype guardian is |
the default setting for the C and C++ compilers in the Guardian environment. |
To use the remove_oss() or remove_guardian() functions, specify the _TANDEM_SOURCE |
feature test macro. |
5−108 Hewlett-Packard Company 527187-007