Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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)