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_damage - Sets damaged attribute on a file or directory SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsam [library ... ] #include "/opt/SUNWsamfs/include/lib.h" int sam_damage(const char *path, int num_opts, ... ); DESCRIPTION sam_damage() lets you mark archive copies of a file or a directory as damaged, using a Sun Storage Archive Manager system call. path is the file on which to set the attri- butes, followed by a sequence of num_opts input characters or options. Individual options are described below. The function marks copies of a file or directory as damaged based on the archive copy number and/or the media type and VSN specified. There are several ways to mark one or more copies as damaged. These ways are as follows: o By copy number o By copy number, media type, and VSN o By copy number and media type o By media type o By media type and VSN If a fatal error is detected when staging an archive copy, that archive copy is marked as damaged. An archive copy that is damaged is not selected for staging. OPTIONS a Rearchives the damaged copy. c copy_no Marks the specified archive copy number as dam- aged. If one or more 'c' options are specified, only those archive copies (1, 2, 3, or 4) are marked as damaged. Specify 1, 2, 3, or 4 for copy_no. Either a "c copy_no" or a "m media" option must be specified. M Marks only metadata as damaged. This includes directories, the segment index, and removable-media files. Regular files are not marked as damaged. If you are marking a directory as damaged, you must specify the "M" option. m media_type Marks all copies from the specified media_type as damaged. For the list of possible media_type specifications, see the mcf(4) man page. Either a "c copy_no" or a "m media" option must be speci- fied. If you specify a "m media" option, you can also specify a "v vsn" option. o Specifies that the file must be online before it is marked as damaged. If the file is offline, the sam_damage function stages the file to disk before deleting any entries. v vsn Marks the archive copies on vsn as damaged. For vsn, specify a volume serial name (VSN). If you specify a "v vsn" option, you must also specify a "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_damage() 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_damage() 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 damage(1m), mcf(4)