Symantec logo

qiomkfile

NAME

qiomkfile - create a VxFS Quick I/O device file

SYNOPSIS

qiomkfile [ -h [ headersize ]] [ -a ] -s size file

qiomkfile [ -e | -r ] size file

AVAILABILITY

VRTSvxfs

DESCRIPTION

qiomkfile creates a raw character device file using a file name extension and a regular file with preallocated, contiguous disk space. This improves Online Transaction Processing (OLTP), allowing databases to access a regular file as a raw device. qiomkfile also creates a symbolic link file with the character device name extension ::cdev:vxfs: so that the file can be accessed via the Quick I/O for Databases device driver in a VERITAS file system.

Use the -h headersize option to create Oracle-specific datafiles. If the size of the file including the header is not a multiple of the file system block size, it is rounded to a multiple of the file system block size before preallocation.

For other databases, omit the -h option to create files.

OPTIONS

-a

Creates a symbolic link with an absolute path name for the specified file. Omitting this option creates a symbolic link with a relative path name. Use -a when absolute path names are required (for example, when using Quick I/O with SAP).

-e size

Extends the size of the specified file by size to allow Oracle tablespace resizing. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes. Maximum file size is two terabytes minus one.

-h " headersize"

Creates a file named file with additional space allocated for the Oracle header. headersize can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, t, g, G, T, b, or B). The default is bytes. Oracle files require additional space equal to one Oracle block to store header information, so headersize should be equal to the Oracle block size. 32K is the default if headersize is omitted.

-r size

Increases the specified file to size to allow Oracle tablespace resizing. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes. Maximum file size is two terabytes minus one.

-s size

Preallocates space size for a file. size can be specified in units of bytes, kilobytes, megabytes, gigabytes, terabytes, or sectors by entering the appropriate suffix (k, K, m, M, g, G, t, T, b, or B). The default is bytes.

EXIT CODES

qiomkfile exits with a non-zero status if the attempted operation fails. A non-zero exit code is not a complete indicator of the problems encountered, but rather denotes the first condition that prevented further execution of the command.

EXAMPLES

Create a file named foo of 1 megabyte:

qiomkfile -s 1M foo

Create a file named dbf of 1 megabyte as an Oracle datafile:

qiomkfile -h -s 1M dbf

Create a file named sapdata1 of 1 megabyte, but use an absolute path name for the ::cdev:vxfs: device name extension:

qiomkfile -s 1M -a sapdata1

The following example shows the result after running the above commands:

ls -oa

total 204802

drwxr-xr-x 3 oracle 96 Nov 23 14:05 .

drwxr-xr-x 38 root 1024 Nov 9 18:42 ..

-rw-r--r-- 1 oracle 1081344 Nov 23 14:16 .dbf

lrwxrwxrwx 1 oracle 16 Nov 23 14:16 dbf -> .dbf::cdev:vxfs:

-rw-r--r-- 1 oracle 1048576 Nov 23 14:05 .foo

lrwxrwxrwx 1 oracle 16 Nov 23 14:05 foo -> .foo::cdev:vxfs:

-rw-r--r-- 1 oracle 1048576 Nov 23 14:18 .sapdata1

lrwxrwxrwx 1 oracle 16 Nov 23 14:18 sapdata1 ->

/oradata/.sapdata1::cdev:vxfs:

drwx------ 2 root 96 Nov 20 11:54 lost+found

Increase the size of the file dbf by 20 megabytes:

qiomkfile -e 20M dbf

Increase the size the file dbf to 100 megabytes:

qiomkfile -r 100M dbf

SEE ALSO

getext(1), qioadmin(1), qiostat(1), setext(1), vxtunefs(1M), vxfsio(7)