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

B.3.5 sfxsetext(1) - Specifies extent attribute information

[SYNOPSIS]

sfxsetext -a init-blocks[,inc-blocks] [ -f flags ] file

[DESCRIPTION]

The sfxsetext command specifies extent attribute information for a specified file on the GFS Local 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 Local File System.

[OPTIONS]

-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 are 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.

-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 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 greater than init-blocks:

Allocates a contiguous area for the number of blocks specified in init-blocks.

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.

[EXAMPLES]

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

[SEE ALSO]

sfxadm(1M), sfxcp(1), sfxcpio(1), sfxgetext(1), sfxmv(1)

statvfs(2).

[NOTES]

In some cases, 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.