Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

remove_guardian(3) Guardian Native C 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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
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−116 Hewlett-Packard Company 527192-018