sam_cancelstage - Cancels a file stage
cc [
flag
… ]
file
… -L∕opt∕SUNWsamfs∕lib -lsam [
library … ]
#include "∕opt∕SUNWsamfs∕include∕lib.h"
int sam_cancelstage(const char *
path )
sam_cancelstage()
cancels the stage of the file pointed to by
path.
Only the file owner or superuser can perform this operation on the file.
Upon successful completion a value of 0 is returned.
Otherwise, a value of -1 is returned and
errno
is set to indicate the error.
sam_cancelstage()
fails if one or more of the following are true:
EPERM
Caller is not the file owner or superuser.
EFAULT
buf or path points to an illegal address.
EINTR
A signal was caught during the
sam_cancelstage()
function.
ELOOP
Too many symbolic links were encountered in translating path.
EMULTIHOP
Components of path require hopping to multiple remote machines and the file system does not allow it.
ENAMETOOLONG
The length of the
path
argument exceeds {PATH_MAX
}, or the
length of a path component exceeds {NAME_MAX
} while
{_POSIX_NO_TRUNC
} is in effect.
ENOENT
The named file does not exist or is the null pathname.
ENOLINK
path points to a remote machine and the link to that machine is no longer active.
ENOTDIR
A component of the path prefix is not a directory.