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

remove_oss(3) Guardian Native C Library Calls Reference Manual
NOTES
If the file operated upon by the remove() function has multiple links, the link count in the file is
decremented.
If the file operated upon is a symbolic link, it is not deleted. All special files, including symbolic
links, are processed as if they were directories; because a symbolic link is not a directory, the
attempt to remove it (or the file it points to) fails.
RETURN VALUES
Upon successful completion, the remove() or remove_oss() function returns a value of 0 (zero).
Otherwise, a nonzero value is returned.
ERRORS
Refer to the rmdir(2) and the ulink(2) reference pages for information on error conditions.
RELATED INFORMATION
Functions: link(2), remove(3), remove_guardian(3), rename(2) rmdir(2), unlink(2).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. In the HP
implementation, if the remove() function is passed the name of an open file, that file is no longer
accessible by that name. Existing opens remain viable. When there are no more outstanding
opens, the physical file is removed.
The remove_oss() function is an HP extension to the XPG4 Version 2 specification.
5−84 Hewlett-Packard Company 527192-007