CLI Guide

NOTE: You cannot combine options that specify read or write actions in a command line instance.

Table 6. Read and Write Command Examples

Valid/Invalid DTK Command Line Example

valid

syscfg --option1 --option2

valid

syscfg --option1=arg --option2=arg

invalid

syscfg --option1=arg --option2

File Input And Output Commands

• Specify the le input using the -i <filename> command, where <filename> is the name of the input le.

• Specify the le output using the -o <filename> command, where <filename> is the name of the output le.

Log Files

If the log le already exists, information is appended to the le. This allows multiple tools to use the same log le to record

information. Use the -l option to record the output of a utility.

The log duplicates all standard output and error information to the specied le. Each log le begins with a time stamp and utility

name. For example, YYYY/MM/DD HH:MM:SS < utilname > - <output text> .

The following is an example of the logging behavior:

2003/11/28 10:23:17 syscfg - option1=on

2003/11/28 10:23:17 syscfg - option2=on

2003/11/28 10:23:17 syscfg - option3 =off

NOTE: The log les may contain sensitive information such as passwords and authentication information. To protect such

information, it is recommended that only the administrator accesses the log les.

Help Option

The -h and --help options display general usage information for the utility. If the argument matches a valid option, that usage

information of the option is displayed. If the option has arguments, the arguments are displayed, separated by a | character. If the

argument does not match a valid option, a usage error is given (and usage information is displayed). This option cannot be replicated.

Error Checking And Error Messages

The DTK utilities check your commands for correct syntax when you enter them. When a command is executed successfully, a

message displays stating that your command has been successful. Unrecognized or invalid options and arguments result in a usage

error that displays the DTK utility name and version along with a short message. For information about the error messages, see

Messages And Codes.