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_segment - Sets segment attributes on a file or directory SYNOPSIS cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsam [library ... ] #include "/opt/SUNWsamfs/include/lib.h" int sam_segment(const char *path, const char *ops); DESCRIPTION sam_segment() sets segment attributes on a file or directory using a Sun QFS or SAM-QFS system call. If a file is seg- mented, it is archived and staged in segment size chunks. sam_segment() is not supported on a SAM-QFS shared file sys- tem. path is the file on which to set the attributes. ops is the character string of options, for example: "dl104857600". Individual options are described below. OPTIONS d Return the segment file attributes on the file to the default, i.e. reset to the file access instead of seg- ment access. It not possible to reset a file that has already been segmented. When this option is specified, the attributes are reset to the default. If it is used, it should be the first character in the string. l n Specifies the segment size in units of bytes. The segment_size must be greater than or equal to one mega- byte. This segment size is the size at which the file will be segmented for purposes of archiving and stag- ing. An error is returned if the file is greater than the segment size. s n Specifies the number of segments to stage ahead when staging a segmented file. This means when an offline segment is read, in addition to staging the current segment, the next n segments are also staged. The default n is zero, which means there is no stage read ahead. The maximum n is 255. 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_segment() 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. The file exceeds the speci- fied segment size. EPERM Not the owner or superuser. EFAULT path or ops points to an illegal address. EINTR A signal was caught during the sam_segment() 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. ENOTSUP License does not support segment. SEE ALSO segment(1)