From e448824f9dac207f0198d2284988fcf97243d30e Mon Sep 17 00:00:00 2001 From: Jeff Blaine Date: Thu, 26 May 2011 14:22:52 -0400 Subject: [PATCH] Added fstrace subcommand help to binary Added subcommand help to fstrace binary. Change-Id: I00ef50a27ec9bf799c84b1c8d949a75e6be36eb3 Reviewed-on: http://gerrit.openafs.org/4727 Tested-by: BuildBot Reviewed-by: Derrick Brashear --- src/venus/fstrace.c | 42 ++++++++++++++++++++++++++---------------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/src/venus/fstrace.c b/src/venus/fstrace.c index fe6f85f..a9c9d32 100644 --- a/src/venus/fstrace.c +++ b/src/venus/fstrace.c @@ -1751,15 +1751,17 @@ SetUpDump(void) dumpSyntax = cmd_CreateSyntax("dump", DoDump, NULL, "dump AFS trace logs"); - (void)cmd_AddParm(dumpSyntax, "-set", CMD_LIST, CMD_OPTIONAL, "set_name"); + (void)cmd_AddParm(dumpSyntax, "-set", CMD_LIST, CMD_OPTIONAL, + "event set name"); (void)cmd_AddParm(dumpSyntax, "-follow", CMD_SINGLE, CMD_OPTIONAL, - "log_name"); + "trace log name"); (void)cmd_AddParm(dumpSyntax, "-file", CMD_SINGLE, CMD_OPTIONAL, - "output_filename"); + "path to trace log file for writing"); (void)cmd_AddParm(dumpSyntax, "-sleep", CMD_SINGLE, CMD_OPTIONAL, - "seconds_between_reads"); + "interval (secs) for writes when using -follow"); } + static int DoShowLog(struct cmd_syndesc *as, void *arock) { @@ -1826,9 +1828,12 @@ SetUpShowLog(void) showSyntax = cmd_CreateSyntax("lslog", DoShowLog, NULL, "list available logs"); - (void)cmd_AddParm(showSyntax, "-set", CMD_LIST, CMD_OPTIONAL, "set_name"); - (void)cmd_AddParm(showSyntax, "-log", CMD_LIST, CMD_OPTIONAL, "log_name"); - (void)cmd_AddParm(showSyntax, "-long", CMD_FLAG, CMD_OPTIONAL, ""); + (void)cmd_AddParm(showSyntax, "-set", CMD_LIST, CMD_OPTIONAL, + "event set name"); + (void)cmd_AddParm(showSyntax, "-log", CMD_LIST, CMD_OPTIONAL, + "trace log name"); + (void)cmd_AddParm(showSyntax, "-long", CMD_FLAG, CMD_OPTIONAL, + "show defined log size in kbytes & if it is allocated in kernel mem"); } static int @@ -1882,7 +1887,8 @@ SetUpShowSet(void) showSyntax = cmd_CreateSyntax("lsset", DoShowSet, NULL, "list available event sets"); - (void)cmd_AddParm(showSyntax, "-set", CMD_LIST, CMD_OPTIONAL, "set_name"); + (void)cmd_AddParm(showSyntax, "-set", CMD_LIST, CMD_OPTIONAL, + "event set name"); } static int @@ -1940,9 +1946,9 @@ SetUpClear(void) cmd_CreateSyntax("clear", DoClear, NULL, "clear logs by logname or by event set"); (void)cmd_AddParm(clearSyntax, "-set", CMD_LIST, CMD_OPTIONAL, - "set_name"); + "event set name"); (void)cmd_AddParm(clearSyntax, "-log", CMD_LIST, CMD_OPTIONAL, - "log_name"); + "trace log name"); } static int @@ -2026,10 +2032,14 @@ SetUpSet(void) setSyntax = cmd_CreateSyntax("setset", DoSet, NULL, "set state of event sets"); - (void)cmd_AddParm(setSyntax, "-set", CMD_LIST, CMD_OPTIONAL, "set_name"); - (void)cmd_AddParm(setSyntax, "-active", CMD_FLAG, CMD_OPTIONAL, ""); - (void)cmd_AddParm(setSyntax, "-inactive", CMD_FLAG, CMD_OPTIONAL, ""); - (void)cmd_AddParm(setSyntax, "-dormant", CMD_FLAG, CMD_OPTIONAL, ""); + (void)cmd_AddParm(setSyntax, "-set", CMD_LIST, CMD_OPTIONAL, + "event set name"); + (void)cmd_AddParm(setSyntax, "-active", CMD_FLAG, CMD_OPTIONAL, + "enable tracing for event set & allocate kernel memory"); + (void)cmd_AddParm(setSyntax, "-inactive", CMD_FLAG, CMD_OPTIONAL, + "disables tracing for event set, keep kernel memory"); + (void)cmd_AddParm(setSyntax, "-dormant", CMD_FLAG, CMD_OPTIONAL, + "disable tracing for event set & free kernel memory"); } static int @@ -2084,9 +2094,9 @@ SetUpResize(void) cmd_CreateSyntax("setlog", DoResize, NULL, "set the size of a log"); (void)cmd_AddParm(setsizeSyntax, "-log", CMD_LIST, CMD_OPTIONAL, - "log_name"); + "trace log name"); (void)cmd_AddParm(setsizeSyntax, "-buffersize", CMD_SINGLE, CMD_REQUIRED, - "1-kilobyte_units"); + "# of 1-kbyte blocks to allocate for log"); } #include "AFS_component_version_number.c" -- 1.9.4