vxcmdlog(1M)															      vxcmdlog(1M)

NAME

       vxcmdlog - administer command logging

SYNOPSIS

       vxcmdlog [-H] [-l] [-m {on|off}] [-n number] [-s size]

DESCRIPTION

       The  vxcmdlog  command  is used to administer command logging in Veritas Volume Manager (VxVM). This feature can be used to record all VxVM
       commands that are issued, and can be used in conjunction with the transaction logging feature (see vxtranslog(1M)).

       When the current log file reaches a maximum size, it is renamed as a historic log file, and a new current log file is  created.	A  limited
       number of historic log files is preserved to avoid filling up the file system.

       Each  log file contains a header that records the host name, host ID, and the date and time that the log was created. See the EXAMPLES sec-
       tion below for a description of the entries that are recorded in a log file.

OPTIONS

       -H	 Displays detailed help about the usage of the command.

       -l	 Lists current settings for command logging. This shows whether command logging is enabled, the maximum  number  of  historic  log
		 files, and the maximum log file size.

       -m {on|off}
		 Turns command logging on or off.  By default, command logging is turned on.

       -n number Sets  the  maximum number of historic log files to maintain.  The default number is 5.  If number is set to no_limit, there is no
		 limit on the number of historic log files that are created.

       -s size	 Sets the maximum size to which a command log can grow.  (Note that this setting has no effect on existing historic log files.)

		 The suffix modifiers k, m, and g may be used express sizes in kilobytes, megabytes and gigabytes respectively.  If no	suffix	is
		 specified, the default units are kilobytes.

		 If size is set to no_limit, there is no limit on the size of the log file.

		 The size of the command log is checked after an entry has been written so the actual size may be slightly larger than that speci-
		 fied. When the log reaches the specified size, the current command log file, cmdlog, is renamed as the  next  available  historic
		 log  file,  cmdlog.number,  where  number  is	an integer from 1 up to the maximum number of historic log files that is currently
		 defined.

		 If the maximum number of historic log files has been reached, the oldest historic log file is removed, and the current  log  file
		 is renamed as that file.

		 The default maximum size of the command log file is 1m(1MB).

EXAMPLES

       Turn on command logging:

	      vxcmdlog -m on

       Set the maximum command log file size to 512KB:

	      vxcmdlog -s 512k

       Set the maximum number of historic command log files to 10:

	      vxcmdlog -n 10

       The following are sample entries from a command log file:

		  /usr/sbin/vxdctl mode
		  /usr/sbin/vxdisk -q -o alldgs list
		  /etc/vx/diag.d/vxprivutil dumpconfig /dev/vx/rdmp/Disk_4s2
		  /usr/sbin/vxdisk list SENA0_1

       Each  entry  usually  contains a client ID that identifies the command connection to the vxconfigd daemon, the process ID of the command, a
       time stamp, and the command that was used together with its arguments.  If the client ID is 0, as in the third entry shown here, this means
       that the command did not open a connection to vxconfigd.

       Note: The client ID is the same as that recorded for the corresponding transactions in the transactions log.

FILES

       /etc/vx/log	       Symbolic link to the log directory. This can be redefined if necessary.

       /etc/vx/log/cmdlog      Current command log.

       /etc/vx/log/cmdlog.number
			       Historic command logs.

NOTES

       If vxcmdlog records the invocation of a vxmake command that reads object definitions from a description file, vxcmdlog additionally records
       the contents of the description file.

       Most command scripts are not logged, but the command binaries that they call are logged. Exceptions are	the  vxdisksetup,  vxinstall,  and
       vxdiskunsetup scripts, which are logged.

SEE ALSO

       vxtranslog(1M)

       Veritas Volume Manager Troubleshooting Guide

VxVM 5.0.31.1							    24 Mar 2008 						      vxcmdlog(1M)