qiomkfile(1)qiomkfile(1)NAMEqiomkfile - create a VxFS Quick I/O device file
SYNOPSIS
/opt/VRTS/bin/qiomkfile [ -h [ headersize ]] [ -a ] -s size file
qiomkfile [ -e | -r ] size file
AVAILABILITY
VRTSvxfs
DESCRIPTIONqiomkfile creates a raw character device file using a file name exten‐
sion 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 sym‐
bolic 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.
You must be a privileged user to run qiomkfile.
Cluster File System Issues
Quick I/O works on VxFS cluster file systems, but Cached Quick I/O is
not currently supported.
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 Ora‐
cle 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 addi‐
tional space equal to one Oracle block to store header infor‐
mation, 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 CODESqiomkfile exits with a non-zero status if the attempted operation
fails. A non-zero exit code is not a complete indicator of the prob‐
lems 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 com‐
mands:
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 ALSOqioadmin(1), qiostat(1), getext(1M), setext(1M), vxtunefs(1M), vxf‐
sio(7)VxFS 5.0 7 Jan 2008 qiomkfile(1)