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

remove_guardian(3) OSS Library Calls Reference Manual
NAME
|
remove_guardian - Removes a file (Guardian 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_guardian( |
const char *file_name); |
PARAMETERS
|
file_name ||
Points to the file to be removed. |
DESCRIPTION |
The remove() Guardian function and remove_guardian() 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 Guardian environment. Unless otherwise noted, this refer- |
ence page uses remove() to refer to both the remove() Guardian function and |
remove_guardian() function. |
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. |
RETURN VALUES
|
Upon successful completion, the remove() or remove_guardian() function returns a value of 0 |
(zero). Otherwise, a nonzero value is returned. |
5−106 Hewlett-Packard Company 527187-007