sam_rearch(3)

NAME
     sam_rearch - Sets rearchive attributes on a file  or  direc-
     tory

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

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

     int sam_rearch(const char *path, int num_opts, ... );

DESCRIPTION
     sam_rearch() sets rearchive attributes on a file  or  direc-
     tory  using a Sun Storage Archive Manager system call.  path
     is the file on which to set the attributes,  followed  by  a
     sequence  of  num_opts input characters or options.  Indivi-
     dual options are described below.

OPTIONS
     c copy_no
          Specifies the archive copy number.  If one or more  'c'
          options are specified, only those archive copies (1, 2,
          3 or 4) are marked. If not specified,  the  default  is
          all copies only in the case that media type and VSN are
          specified, using the  "m  media"  option  and  "v  vsn"
          option.

     M    Rearchives metadata only.  This  includes  directories,
          the  segment  index, and removable media files. Regular
          files and symbolic links are not rearchived.

     m media
          Specifies the media type.  If specified, archive copies
          on the specified media are marked.  This option must be
          specified in conjunction with the "v vsn" option.   For
          more  information  on  media  types, see the mcf(4) man
          page.

     o    Requires the file to be online before its archive entry
          is  rearchived.   If  the file is offline, the function
          stages  the  file  onto  disk  before  rearchiving  any
          entries.

     v vsn
          Marks archive copies on VSN vsn for rearchiving.   This
          option  must  be  specified  in conjunction with the "m
          media" option.

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_rearch() fails if one or more of the following are true:

     EINVAL              An invalid option was specified, or  the
                         file  is  neither  a  regular file nor a
                         directory.

     EPERM               Not the owner or superuser.

     EFAULT              Argument points to an illegal address.

     EINTR               A   signal   was   caught   during   the
                         sam_rearch() function.

     ELOOP               Too many symbolic links were encountered
                         in translating path.

     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
     rearch(1m), mcf(4)