Symantec logo

qlogadm

NAME

qlogadm - low level ioctl utility for QuickLog driver

SYNOPSIS

qlogadm [ -V ] [ -f ] [ -g diskgroup ] remove qlogdev

qlogadm [ -V ] [ -g diskgroup ] attach qlogdev qlogvol

qlogadm [ -V ] [ -g diskgroup ] detach qlogdev qlogvol

qlogadm [ -V ] [ -g diskgroup ] cleaner qlogdev

qlogadm [ -V ] [ -g diskgroup ] flush qlogdev

qlogadm [ -V ] [ -g diskgroup ] enabled qlogdev fsvol

qlogadm [ -V ] [ -g diskgroup ] query qlogdev

qlogadm [ -V ] [ -g diskgroup ] start qlogdev fsvol

qlogadm [ -V ] [ -g diskgroup ] stop qlogdev fsvol

qlogadm [ -V ] [ -g diskgroup ] suspend qlogdev fsvol

qlogadm [ -V ] [ -g diskgroup ] resume qlogdev fsvol

AVAILABILITY

VRTSvxfs

DESCRIPTION

The qlogadm command performs low-level ioctl functions on the QuickLog driver. qlogadm can modify and display most basic kernel states. qlogadm is typically used for debugging and development and is not required to operate QuickLog.

Caution: Incorrect use of this command can cause unrecoverable data corruption. Do not use this command unless you are an expert user.

NOTES

QuickLog does not operate on the Version 6 disk layout introduced in the VxFS 4.0 release. VxFS 4.0 is the last major release to support QuickLog. QuickLog functionality is being replaced by the Multi-Volume Support (MVS) feature of VxFS. For information on how to migrate your systems from QuickLog to MVS, see the Veritas File System Administrator's Guide.

Cluster File System Issues

The above usage warnings also apply to cluster QuickLog devices.

Cluster QuickLog devices do not use the /etc/qlog/config file to maintain cluster configuration information.

KEYWORDS

attach

Attaches the QuickLog volume qlogvol to the QuickLog device qlodgev. Note: Attaching a QuickLog device does not modify the /etc/qlog/config configuration file.

cleaner

Manually starts the cleaning process on qlogdev.

detach

Detaches the QuickLog volume qlogvol from the QuickLog device qlogdev. If qlogvol is the only QuickLog volume attached to qlogdev, and one or more VxFS file systems are still enabled on qlogdev, the detach operation will fail. Note: Detaching a QuickLog device does not modify the /etc/qlog/config configuration file.

enabled

Checks if the VxFS file system, fsvol, is enabled on the QuickLog device qlogdev.

flush

Writes both copies of the kernel super-block and maps to all QuickLog volumes attached to qlogdev.

query

Prints the super-block of the QuickLog device qlogdev.

remove

Removes the QuickLog device qlogdev. If there are QuickLog volumes attached to qlogdev, the QuickLog volumes are detached before the removal of the QuickLog device. Note: Removing a QuickLog device does not modify the /etc/qlog/config configuration file.

resume

Re-enables a suspended VxFS file system, fsvol, on a QuickLog device qlogdev.

start

Enables a VxFS file system, fsvol, for logging on a QuickLog device qlogdev.

stop

Stops a VxFS file system, fsvol, from logging on a QuickLog device qlogdev.

suspend

Temporarily disables a VxFS file system, fsvol, on a QuickLog device qlogdev.

OPTIONS

-f

Forcibly removes the QuickLog device even if there are mounted file systems enabled on the device. This disables any QuickLog-enabled file systems on the QuickLog device. The disabled file systems require a full file system check before being re-enabled (see fsck_vxfs(1M)).

-g diskgroup

The disk group of the QuickLog volume. Use this option only when qlogvol is controlled by the Veritas Volume Manager (VxVM). An error occurs if specified for a qlogvol that is not under VxVM control. The disk group of the QuickLog volume must match the disk group of the QuickLog device and all VxFS file systems logged by this device.

-V

Runs the command in verbose mode.

ARGUMENTS

fsvol

The name of a VxVM volume or raw disk partition that is used as a VxFS file system. You can also specify fsvol using the full path name. The following paths are valid: /dev/vx/rdsk/dg/fsvol (for Veritas Volume Manger volumes), or /dev/rdsk/fsvol (for raw disk partitions; in this case, qlogvol is a disk partition; for example, c0t0d1s3).

qlogdev

The QuickLog device upon which the ioctl command is used. This field must be specified with all keywords. If the QuickLog volume is controlled by VxVM, the QuickLog volume's disk group must match the disk group of qlogdev. You can also specify qlogdev using the full path name (for example /dev/qlog/qlogdev).

qlogvol

The name of a VxVM volume or raw disk partition to use as a QuickLog volume. You can also specify qlogvol using the full path name. The following paths are valid: /dev/vx/rdsk/dg/qlogvol (for VxVM volumes), or /dev/rdsk/qlogvol (for raw disk partitions; in this case, qlogvol is a disk partition; for example, c0t0d1s3).

EXIT CODES

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

FILES

/etc/qlog/config

QuickLog configuration file.

SEE ALSO

fsck_vxfs(1M), qlogattach(1M), qlogclustadm(1M), qlogdetach(1M), qlogdisable(1M), qlogenable(1M), qlogrm(1M), qlog_config(4) qlog(7)

Veritas File System Administrator's Guide