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

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 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−182 Hewlett-Packard Company 527187-017