stripe(8) [osf1 man page]
stripe(8) System Manager's Manual stripe(8) NAME
stripe - Stripes a file across several volumes in a file domain SYNOPSIS
/usr/sbin/stripe -n volume_count filename OPTIONS
Specifies the number of volumes the striped file crosses. The number of volumes must be greater than one. OPERANDS
Specifies the name of the file to stripe. DESCRIPTION
The stripe utility enables you to improve the read/write performance of a file. The stripe utility directs a zero-length file (a file with no data written to it yet) to be spread evenly across several volumes within a file domain. As data is appended to the file, the data is spread across the volumes. AdvFS determines the number of pages per stripe segment and alternates the segments among the disks in a sequen- tial pattern. Existing, nonzero-length files cannot be striped using the stripe utility. To stripe an existing file, create a new file, use the stripe utility to stripe the new file, and copy the contents of the file you want to stripe into the new striped file. After copying the file, delete the nonstriped file. Once a file is striped, you cannot use the stripe utility to modify the number of disks that a striped file crosses. To change the volume count of a striped file, you can create a second file with a new volume count, and then copy the contents of the first file into the second file. After copying the file, delete the first file. RESTRICTIONS
You cannot stripe a nonzero-length file or a file that is already striped. EXAMPLES
The following example stripes the file abc across three volumes in the same file domain: # stripe -n 3 abc The following example stripes an existing, nonzero-length file, foo, across three volumes in the same domain. First a new file, newfoo, is created and striped. Then, the contents of file foo are copied to the new, striped file: # touch newfoo # stripe -n 3 newfoo # cp foo newfoo SEE ALSO
advfs(4), showfile(8) stripe(8)
Check Out this Related Man Page
advfs_set_file_attributes(3) Library Functions Manual advfs_set_file_attributes(3) NAME
advfs_set_file_attributes - Set AdvFS file attributes SYNOPSIS
#include <sys/advfs_syscalls.h> int advfs_set_file_attributes( int fd, fileAttributesT *fileAttributes ); LIBRARY
AdvFS Library (libadvfs) PARAMETERS
An open file descriptor of the file for which you want attributes set. A pointer to a structure that contains the file attributes. DESCRIPTION
This function sets a file's AdvFS-specific attributes to the attributes that are defined in the specified fileAttributes structure. How- ever, the function does not set any attributes that are marked as reserved in the fileAttributes structure. RESTRICTIONS
If the stripe.segmentCnt field is set to a value greater than the total number of volumes in the AdvFS file domain, an error is returned. You must have the AdvFS Advanced Utilities license to set a file's mapType to XMT_STRIPE. RETURN VALUES
The function returns a value of 0 (zero) on successful completion. The function returns a value of -1 on failure and sets the value of errno to the specific error. ERRORS
The function sets errno to the specified errors for the following failure conditions: The file descriptor fd is not pointing to a file that resides in an AdvFS fileset. An I/O error occurred on one of the disks containing the file. The fileAttributes.writeOrder field contains a value other than ADVFS_WO_ASYNC_WRITE, ADVFS_WO_DATA_LOGGING, or ADVFS_WO_SYNC_WRITE. The fileAttributes.mapType field contains a value other than XMT_SIMPLE or XMT_STRIPE. The fileAttributes.mapType field is set to XMT_STRIPE and the fileAttributes.stripe.segmentCnt field contains a value less than 2 or greater than the number of volumes in the domain. There is not enough memory available for the operation. SEE ALSO
Commands: chfile(8), showfile(8), stripe(8) Functions: open(2), advfs_get_file_attributes(3) advfs_set_file_attributes(3)