archive ( 1 ) User Commands archive ( 1 ) NAME archive ± Set archive attributes and archive ®les SYNOPSIS archive [± d] [± f] [± n] ®lename. archive [± d] [± f] [± n] ± r dirname. [®lename. ] AVAILABILITY LSCsamfs DESCRIPTION archive sets archive attributes on and archives one or more ®les. By default, a ®le is archived some time after its creation. (Default archive operation is con®gured by the system administrator.) If neither ± n nor ± d is speci®ed the ®les are marked to be archived immediately. When archive attributes are set on a directory, ®les or directories subsequently created in that directory inherit those attributes. OPTIONS ± d Return the archive attributes on the ®le to the default. When this option is speci®ed attributes are ®rst reset to the default, then other attribute-setting options are processed. The only action taken is that attributes are reset; no archiving is done. ± f Do not report errors. ± n Speci®es that this ®le never be archived. Only the super-user can set this attribute on a ®le. When this option is speci®ed, the only action taken is that the attribute is set. This attribute cannot be set on a ®le that has either the checksum generate or use (ssum ± g or ssum ± u) bit set. ± r Recursively archive or set the attributes for any ®les contained in the speci®ed dirname or its subdirectories. SEE ALSO stage(1), release(1), ssum(1) LSC Incorporated Last change: 02 Jul 1997 1 release ( 1 ) User Commands release ( 1 ) NAME release ± Release disk space and set release attributes SYNOPSIS release [± a] [± d] [± f] [± n] [± p] [± s partial_size] [± V] ®lename. release [± a] [± d] [± f] [± n] [± p] [± s partial_size] [± V] ± r dirname. [®lename. ] AVAILABILITY LSCsamfs DESCRIPTION release sets release attributes of and releases the disk space associated with one or more ®les. At least one archive image must exist for each ®le before its disk space is released. By default, the releaser dae- mon automatically drops disk space when the ®lesystem's high water mark is reached. If any of the ± a, ± d, ± n, ± p, or ± s options is speci®ed, only the attribute is set; the disk space is not released. When release attributes are set on a directory, ®les and directories subsequently created in that directory inherit those attributes. OPTIONS ± a Set the attribute that speci®es that a ®le's disk space be released when at least one archive copy of the ®le exists. Not valid with ± n. ± d Return the release attributes on the ®le to the default. When ± d is speci®ed attributes are ®rst reset to the default, then other attribute-setting options are processed. If the partial attribute is reset, all blocks are released for an of¯ine regular ®le. ± f Do not report errors. ± n Specify that the disk space for this ®le never be released. Only the super-user can set this attri- bute on a ®le. Not valid with ± a or ± p. ± p Set the partial attribute on the ®le so that, when the ®le's disk space is released, the ®rst por- tion of that disk space will be retained. By default, the minimum size of the portion retained on disk is the mount_samfs parameter partial; this is adjustable using the ± s option. Not valid with release ± n. Also not valid with either of the checksum generate or use attributes (ssum ± g or ssum ± u). The partial attribute is mutually exclusive with the stage ± n attribute unless enabled by the data base license key. If the partial attribute is set when the ®le is of¯ine, the partial blocks are not on the disk and the entire ®le will be staged if accessed. The command stage -p can be used to stage the partial blocks to the disk. ± s partial_size Set the partial attribute on the ®le so that, when the ®le's disk space is released, the ®rst partial_size kilobytes of that disk space will be retained. Not valid with release ± n or stage ± n. Also not valid with either of the checksum generate or use attributes (ssum ± g or ssum ± u). The minimum value is 8 kbytes and the maximum value is the maxpartial value set for this ®le system by the mount command (see mount_samfs (1M)). ± r Recursively performs the operation (releasing disk space or setting release attributes) for any ®les contained in the speci®ed dirname or its subdirectories. ± V Turns on verbose display. A message will be displayed for each ®le on which a release will be attempted. SEE ALSO archive(1), stage(1), ssum(1), mount_samfs(1M) LSC Incorporated Last change: 18 Aug 1999 1 request ( 1 ) User Commands request ( 1 ) NAME request ± Create a removable-media ®le SYNOPSIS request [ ± s size ] [ ± p position1[/position2/position3/...] ] [ ± f ®le_id ] [ ± v version ] [ ± o owner ] [ ± g group ] [ ± i information ] media vsn1[/vsn2/vsn3/...] ®le AVAILABILITY LSCsamfs DESCRIPTION request creates a removable-media ®le allowing access to either tape or optical disk. The media is speci®ed by media (see media(5)). vsn is the Volume Serial Name of the media. For tape, each vsn is limited to 6 characters. For optical media the limit is 31 characters. Multiple vsns may be speci®ed by separating them with "/". ®le is the ®le path name of the removable-media ®le to be created. The ®le must reside on a SAM-FS ®le system. Subsequent access to the ®le results in access to the speci®ed removable-media. When a removable-media ®le is written by opening it with o¯ag equal to O_WRONLY, O_RDWR, O_CREAT, or O_TRUNC, the removable-media information in the SAM-FS ®le system is updated to re¯ect the data's position on the medium. Subsequent read access (open with o¯ag equal to O_RDONLY) to the ®le will result in access to the data written during creation. OPTIONS ± s size The required size in bytes. When ®le is opened for write access, suf®cient space on the media must be available before the ®rst write is done. ± p position The position of the removable media ®le on the media, speci®ed in decimal (or hexa- decimal if preceded by "0x"). Note that SAM-FS utilities usually print the position of the ®le on the medium in hexadecimal. If speci®ed, the media is positioned to posi- tion on each vsn. The number of positions must match the number of vsns. You must be super-user to set position. OPTICAL MEDIA OPTIONS ± f ®le_id The recorded ®le name of the ®le to access (up to 31 characters). The default is the ®le name portion (basename) of the path speci®ed by ®le. For requests where ®le is greater than 31 characters, no default exists and the ± f parameter is required. ± v version Version number of the ®le. If version is 0, the most current version will be used for read access and a new version will be created for write access. The default value is 0. For write access, the ®le will be updated with the new version number. ± o owner Owner identi®er (up to 31 characters). The default is the current user. ± g group Group identi®er (up to 31 characters). The default is the user's current group. ± i information User information string. The information string is written in the ®le's label at creation time (up to 159 characters). EXAMPLE Here is an example for disaster recovery of a tape-resident archive ®le at position 286 hexadecimal on DLT volume YYY: request -p 0x286 lt YYY /sam1/xxx NOTE Removable-media ®les are not supported over NFS. For optical disk ®les that are to be used to read archive images, the group (± g) must be the group sam_archive, and the owner (± o) must be sam_archive. LSC Incorporated Last change: 13 Jul 1998 1 request ( 1 ) User Commands request ( 1 ) For tape ®les, each write to the media results in one tape block. Each read of the media returns a tape block. SEE ALSO basename(1), open(2), media(5) LSC Incorporated Last change: 13 Jul 1998 2 setfa ( 1 ) User Commands setfa ( 1 ) NAME setfa ± set ®le attributes SYNOPSIS setfa [± d] [± f] [± D] [± g stripe_group] [± l length] [± s stripe] [± V] ®lename. setfa [± d] [± f] [± D] [± g stripe_group] [± l length] [± s stripe] [± V] ± r dirname. [®lename. ] AVAILABILITY LSCsamfs DESCRIPTION setfa sets attribute for a new or existing ®le. The ®le is created if it does not already exist. When ®le attributes are set on a directory, ®les and directories subsequently created in that directory inherit those attributes. OPTIONS ± d Return the ®le attributes on the ®le to the default. When ± d is speci®ed attributes are ®rst reset to the default, then other attribute-setting options are processed. ± f Do not report errors. ± D Speci®es that the direct I/O attribute be set for this ®le. This means data is transferred directly between the user's buffer and disk. This attribute should only be set for large block aligned sequential I/O. The default I/O mode is buffered (uses the page cache). ± g stripe_group Speci®es the number of the striped group where the ®le is to be preallocated. stripe_group is a number 0 .. 127, and must be a striped_group de®ned in the ®lesystem. ± l length Speci®es the number of bytes to be preallocated to the ®le. This can only be applied to a ®le of zero size. This option is ignored for a directory. If an I/O attempts to extend a preallocated ®le, the caller will get an ENXIO error. ± s stripe Speci®es the number of allocation units to be allocated before changing to the next unit.