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 path name (/.:/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.
-help
Prints 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(8dfs)