PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)

F.3.6 sfcsetext(1) Specifies extent attribute information

[SYNOPSIS]

sfcsetext -a init-blocks[,inc-blocks ] [ -c ] [ -f flags ] file...

[DESCRIPTION]

The sfcsetext command specifies extent attribute information for a specified file on the GFS Shared File System.

After creating the specified file, this command specifies extent attribute information according to the specified options. In this case, the initial area allocated by the number of blocks specified in init-blocks is allocated.

However, extent attribute information cannot be specified when the specified file already exists or does not belong to the GFS Shared File System.

After the extent attribute information is set to a directory, files and subdirectories created in the directory inherit the file data allocation attribute information of the directory.

[OPTIONS]

The following options can be specified:

-a init-blocks[,inc-blocks ]

init-blocks specifies the number of blocks allocated to the file as the initial area. Zero (0) cannot be specified.

inc-blocks specifies the increment (in blocks) when write data exceeds the initial area. If 0 is specified for inc-blocks or inc-blocks is not specified, the normal allocation is used.

When noextend is specified using the -f option, either specify 0 for inc-blocks or do not specify the option.

init-blocks and inc-blocks must be specified in the unit of blocks (eight kilobytes) used for the file system.

-c

Set extent attribute only. New file is specified without -c option, it will be created with the parent directory's policy attributes and extent attribute. When a directory specified with -c, other policy attributes that was set to it are cleared, and only extent attribute is set. When a directory specified without -c, it will have existing policy attribute and extent attribute.

-f flags

This option specifies the data area allocation method. The combination of the flags below can be specified for flags. To specify more than one flag, use a comma (,) as the delimiter.

contig

Allocates a contiguous area for the number of blocks specified in init-blocks and inc-blocks. Depending on the number of blocks specified in inc-blocks, the init-blocks area is allocated as shown below.

If 0 is specified:

Allocates a contiguous area for the number of blocks specified in init-blocks. If it cannot be allocated, then error information is returned.

If less than init-blocks:

Searches for a contiguous space that is equivalent to the number of blocks specified in init-blocks If it cannot be found, the system allocates a contiguous area for init-blocks using the blocks specified in inc-blocks. If the specified value in inc-blocks is not a multiple of init-blocks, the system allocates a contiguous area for the number of blocks specified in inc-blocks, and then allocates a contiguous area for the remaining (including fractional) blocks. If it cannot be allocated, then error information is returned.

If greater than init-blocks:

Allocates a contiguous area for the number of blocks specified in init-blocks. If it cannot be allocated, then error information is returned.

noextend

If the write data exceeds the number of blocks specified in init-blocks or the file size is changed, additional area is not allocated, and error information is returned.

If the -f option or contig is not specified, the system does not necessarily allocate a contiguous area for the number of blocks specified in init-blocks or inc-blocks.

[OPERAND]

The following operand can be specified:

file...

Specifies a general file to target for the transaction or path name of the directory.

[EXAMPLES]

% sfcsetext -a 1024,512 -f contig /mnt/file1
% sfcsetext -a 2048 -f noextend /mnt/file2
% sfcsetext -a 512 -f contig,noextend /mnt/file3
% sfcsetext -a 512 /mnt/file4

[SEE ALSO]

sfccp(1), sfccpio(1), sfcgetext(1), sfcmv(1), sfcsetvolume(1).

statvfs(2) in the "Solaris X Reference Manual Collection."

[NOTES]

• If contig is specified using the -f option, even though the file system has sufficient space, area allocation fails because of the specified option values.
• For init-blocks and inc-blocks, think about the value to be specified as the required number of blocks. If the number of blocks is unnecessarily large, used area increases, causing disk resources to be used inefficiently.