test veritas logo


AMFCONFIG(1M)

NAME

amfconfig - Asynchronous Monitoring Framework (AMF) driver configuration utility

SYNOPSIS

amfconfig -chfoOUV [ -S module,module,.. ] [ -R module,module,.. ] [ -p dbglog | dbgmask | errlevel module ]

amfconfig -D

DESCRIPTION

The amfconfig utility sets up and maintains the configuration of the AMF driver.

OPTIONS

-c Configure the AMF driver.
-h Show usage message.
-U [-o] [-f] Unconfigure the AMF driver. If -o option is specified the command does not ask for confirmation. If -f option is specified the driver would force all the waiters to exit. The -f option also stops the Intelligent Monitoring Framework Daemon (IMFD).
-D Stop the IMFD.
-V Display AMF driver version information
-p dbglog [-O outfile]
  Display the AMF driver debug log to standard output. If output file is specified using the -O option the output goes to the file instead on standard output.
-p dbglogsz
  Display the AMF driver debug buffer log size in Kilo bytes.
-p processhashsz
  Display the process hash size
-p mnthashsz
  Display the mount hash size
-p conthashsz
  Display the container hash size (On Solaris10/1 6.1 and later)
-p filehashsz
  Display the file hash size (On Solaris10/1 6.1 and later)
-p dirhashsz
  Display the directory hash size (On Solaris10/1 6.1 and later)
-p dbgmask | errlevel module
o
  dbgmask

Display if debugging is enabled or disabled for each of the module.

o errlevel module

Display the current errlevel for a given module.

o structures
o Dump the AMF internal structures to log.
-T dbgbufsz=size_in_kb | processhashsz=hash_size | mnthashsz=hash_size
o
  Use dbglogsz=size_in_kb option to set the size of AMF driver debug buffer.
o Use processhashsz=hash_size to change the process hash size.
o Use mnthashsz =hash_size to change the mount hash size of the AMF driver. The new debug buffer log size and hash size will take effect when AMF driver is configured for the next time.
-R module,module,..
  Disable the debugging for specified module(s).
-R errlevel module level
  Turn OFF the messages at the specified level for the specified module.
-R syslog | buffer
  Disable AMF driver message to appear in system log or internal AMF driver buffer.
-S module,module,..
  Enable the debugging for specified module(s).
-S errlevel module level
  Turn ON the messages at the specified level for the specified module.
-S syslog | buffer
  Enable AMF driver message to appear in system log or internal AMF driver debug buffer.
module in -R, -S, and -p could take following values    
o all : all debug messages
o pron : process online debug messages
o proff : process offline debug messages
o fs : fs debug messages
o container : container debug messages
o file : file debug messages
o generic: generic debug messages
o reaper : reaper debug messages
o event : event debug messages
o rid : rid debug messages
o drv : driver entry points debug messages
o other : all other debug messages
level in -R and -S option could take the following values
o error : Error messages
o warn : Warning messages
o notice : Notice messages
o info : Informational messages
o function : Function enter and function exit messages
o all : All the above mentioned error levels The info and function debugging messages would only go to the AMF driver internal debug buffer. They never appear in the system log files.

EXAMPLES

o Example 1: Disable AMF debugging for pron module

# amfconfig -R pron

o Example 2: Enable AMF messages to go to internal driver’s buffer

# amfconfig -S buffer

o Example 3: Display contents of AMF driver’s internal buffer

# amfconfig -p dbglog

o Example 4: Display the current debugging mask

# amfconfig -p dbgmask

o Example 5: Enable level FUNCTION for fson module

# amfconfig -S errlevel fson FUNCTION

o Example 6: Disable level INFO for fsoff module

# amfconfig -R errlevel fsoff INFO

o Example 7: Set the process hash size to 3000 and debug log buffer size to 100 KB

# amfconfig -T processhashsz=3000,dbglogsz=100

RETURN VALUES

o 0

The command was successful.

o <0

An error occurred.

FILES

/opt/VRTSamf/bin/amfconfig


08 AMFCONFIG(1M)