NAME

dfstrace clear − Clears server process or kernel trace logs

SYNOPSIS

dfstrace clear [{−set set_name... | −log log_name...}] [−cdsentry server_entry_in_CDS] [−help]

OPTIONS

−set set_name
Specifies the name of each event set whose logs you want to clear. Specify this option or the −log option; omit both to clear all non-persistent kernel logs on the local machine or all non-persistent server process logs for the server process specified with the −cdsentry option.

−log log_name
Specifies the name of each log that you want to clear. Specify this option or the −set option; omit both to clear all non-persistent kernel logs on the local machine or all non-persistent server process logs for the server process specified with the −cdsentry option.

−cdsentry server_entry_in_CDS
Specifies the full DCE pathname (/.:/hosts/machine/process_name) of a server process whose logs you want to clear. Use the −set or −log option with this option to specify a distinct group of server process logs to clear; use this option alone to clear all non-persistent logs associated with the server process. Omit this option to clear kernel logs.

−helpPrints the online help for this command. All other valid options specified with this option are ignored. 

DESCRIPTION

The dfstrace clear command clears the specified server process or kernel logs. If you want to clear a kernel log, it must reside on the local machine.  If you want to clear a server process log, it can reside on any machine; however, you must use the −cdsentry option to specify the appropriate server process.  To clear a specific log, identify the log with the −set or −log option. Use the −cdsentry option to clear a specific server process log, omit that option to clear a specific kernel log.  To clear all kernel logs on a machine, run the dfstrace clear command without any options. To clear all server process logs associated with a particular server, run the command with the −cdsentry option only.  Note that you cannot clear persistent logs in this global manner.  The persistent attribute prevents accidental clearing of important logs. The attribute is assigned to a log when the kernel or server process is compiled and cannot be changed. 

Privilege Required

To clear a kernel log, the issuer must be logged in as root on the local machine. To clear a server process log, the issuer must be listed in the admin list associated with that process on the machine specified with the −cdsentry option (for example, admin.fl for the flserver process and admin.ft for the ftserver process). 

EXAMPLES

The following command clears all logs used by the fx kernel event set on the local machine:

# dfstrace clear fx

The following command clears all logs used by the ftserver process on the machine dewitt:

$ dfstrace clear -cdsentry /.:/hosts/dewitt/ftserver

RELATED INFORMATION

Commands: dfstrace lslog(1m), dfstrace lsset(1m)

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5