sam_cancelstage(3)

NAME
     sam_cancelstage - Cancels a file stage

SYNOPSIS
     cc [ flag  ... ] file    ...  -L/opt/SUNWsamfs/lib  -lsam  [library ... ]

     #include "/opt/SUNWsamfs/include/lib.h"

     int sam_cancelstage(const char *path)

DESCRIPTION
     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.

RETURN VALUES
     Upon successful completion a value of 0 is returned.  Other-
     wise, a value of -1 is returned and errno is set to indicate
     the error.

ERRORS
     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 com-
                         ponent    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.

SEE ALSO
     sam_stage(3), sam_stat(3).