Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

qiomkfile(1)							  qiomkfile(1)

NAME
       qiomkfile - 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

DESCRIPTION
       qiomkfile  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 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 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 ALSO
       qioadmin(1),  qiostat(1),  getext(1M),  setext(1M),  vxtunefs(1M), vxf‐
       sio(7)

VxFS 5.0			  7 Jan 2008			  qiomkfile(1)

Vote for polarhome