Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

remove_oss(3) Guardian Native C 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−76 Hewlett-Packard Company 527192-005