From 3e9c10af0d8fe307408bb82048637b5030d43002 Mon Sep 17 00:00:00 2001 From: Boris Ranto Date: Thu, 2 Jun 2016 12:47:22 +0200 Subject: [PATCH] Apply './OpenIPMI-2.0.19-man.patch' Signed-off-by: Boris Ranto --- lanserv/ipmilan.8 | 13 ++++++++++--- man/ipmi_cmdlang.7 | 36 ++++++++++++++++++------------------ man/ipmi_ui.1 | 10 +++++----- man/openipmi_conparms.7 | 4 ++-- man/openipmicmd.1 | 6 +++--- man/openipmigui.1 | 12 ++++++------ man/openipmish.1 | 12 +++++++++++- man/rmcp_ping.1 | 2 +- man/solterm.1 | 6 +++--- sample/ipmicmd.c | 1 + sample/rmcp_ping.c | 5 +++++ sample/solterm.c | 7 ++++++- ui/basic_ui.c | 25 +++++++++++++++++++++++++ 13 files changed, 96 insertions(+), 43 deletions(-) diff --git a/lanserv/ipmilan.8 b/lanserv/ipmilan.8 index ff43d5c..9360507 100644 --- a/lanserv/ipmilan.8 +++ b/lanserv/ipmilan.8 @@ -29,18 +29,25 @@ address they came in. .SH OPTIONS .TP -.BI \-c\ config-file +\fB\-c\fR file,\ \fB\-\-config\-file\fR file Set the configuration file to one other than the default of .I "/etc/ipmi_lan.conf" .TP -.B \-n +\fB\-i\fR device,\ \fB\-\-ipmi-dev\fR device +Sets the desired device +.TP +\fB\-n\fR,\ \fB\-\-daemonize\fR Stops the daemon from forking and detaching from the controlling terminal. This is useful for running from init. .TP -.B \-d +\fB\-d\fR,\ \fB\-\-debug\fR Turns on debugging to standard output. You generally have to use .B \-n with this. +.TP +\fB\-?\fR,\ \fB\-\-help\fR,\ \fB\-\-usage\fR +Prints brief usage hints message. + .SH CONFIGURATION diff --git a/man/ipmi_cmdlang.7 b/man/ipmi_cmdlang.7 index 917b7f5..7562cb0 100644 --- a/man/ipmi_cmdlang.7 +++ b/man/ipmi_cmdlang.7 @@ -246,7 +246,7 @@ instance, the command to create a domain is The command to list all sensors in a domain named domain1 is .B sensor list domain1. -Each command has a reponse for each object operated on, which is +Each command has a response for each object operated on, which is listed after the command description. In those responses, anything that begins with a .B % @@ -316,7 +316,7 @@ BMC. For that, notice that the LAN connection has an options extra IP and port for the second IP address. OpenIPMI supports these IP addresses and connection, detecting failures, switching between addresses, and other fault-tolerant things. It does this -transparently to the user. Mutiple connections may require special +transparently to the user. Multiple connections may require special OEM support, read the documentation about your specific system if you need this. @@ -336,7 +336,7 @@ or \fI\fP and \fI\fP are the user name and password of the IPMI user to use for the connection. The is the driver number, generally 0. -Options enable and disable various automitic processing and are: +Options enable and disable various automatic processing and are: .PD 0 .HP .B -[no]all @@ -356,7 +356,7 @@ is false by default. is false by default. .HP .B -[no]ipmbscan -- IPMB bus scanning. This turns on scanning IPMB busses when they are found. +- IPMB bus scanning. This turns on scanning IPMB buses when they are found. This is false by default. .HP .B -[no]oeminit @@ -461,7 +461,7 @@ available hacks are: The -M option sets the maximum outstanding messages. The default is 2, ranges 1-63. -Options enable and disable various automitic processing and are: +Options enable and disable various automatic processing and are: .PD 0 .HP .B -[no]all @@ -519,7 +519,7 @@ Domain Created: .RE .B fru -- dump a fru given all it's insundry information. +- dump a fru given all it's sundry information. .TP Response: .RS @@ -533,7 +533,7 @@ Domain .B msg [data...] - Send a command to the given IPMB address on the given channel and -display the response. Note that this does not require the existance +display the response. Note that this does not require the existence of an MC in OpenIPMI. .TP Response: @@ -571,7 +571,7 @@ SEL Rescan done: .RE .B presence -- Audit the presence of all enities in the domain. Note that this just +- Audit the presence of all entities in the domain. Note that this just starts the process; it will run in the background. .TP Response is: @@ -689,7 +689,7 @@ FRU deleted: - Set the value of a FRU element. The name is the record name, or multi-record. The number is required for fields that need it (custom and multi-record). The value is -an a single value for integers. For strings it is a string +a single value for integers. For strings it is a string type (either binary, ascii, or unicode) and the info. Binary and unicode data is specified as numbers. ascii data is specified in a string. Note that setting a ascii value with no string will @@ -770,7 +770,7 @@ Domain .B info - Dump information about an entity. .TP -Reponse: +Response: .RS .nf Entity @@ -784,7 +784,7 @@ Entity .B fru - Dump the FRU information about the given entity. .TP -Reponse: +Response: .RS .nf Entity @@ -813,7 +813,7 @@ Entity .B set_act_time - Set the hot-swap auto-activate time. .TP -Reponse: +Response: .RS .nf Set act time: @@ -981,7 +981,7 @@ Response: .nf Sensor Name: - Positivie Hysteresis: + Positive Hysteresis: Negative Hysteresis: .fi .RE @@ -1101,7 +1101,7 @@ Set done: .RE .B get -- Get the value of a control. The reponse depends +- Get the value of a control. The response depends on the control type. .TP Response: @@ -1128,7 +1128,7 @@ multiple lights. The options values (marked with ) will not be present if local control is set to true. Local control means that the LED takes whatever default function it does on the device -(like disk activity, ethernet activity, hot-swap LED, etc.). +(like disk activity, Ethernet activity, hot-swap LED, etc.). Response for id control: .RS .nf @@ -1325,7 +1325,7 @@ Channel Access - Set information about the MC's channel access. There are two different places where this is stored, the present in-use values (volatile) and the non-volatile storage that is loaded at startup. Note if you specify -channel 0xe, the modified channel will be the current channel. Parms +channel 0xe, the modified channel will be the current channel. Parameters are: .RS .nf @@ -1547,7 +1547,7 @@ PET destroyed: .SS pef commands dealing with platform even filters. These are basically connections to the PEF configuration parameters in an MC. You use a -pef to fetch a pef config, which you can then modify and write back to +pef to fetch a pef configuration, which you can then modify and write back to the MC. Note that when you get a pef config, you claim a lock on the MC that must be unlocked. @@ -1780,7 +1780,7 @@ operational and finished all it SDR, FRU, and bus scans: .fi .RE -The following comes out when domain connection infomration changes: +The following comes out when domain connection information changes: .RS .nf EVENT diff --git a/man/ipmi_ui.1 b/man/ipmi_ui.1 index 9c5d9b6..011255f 100644 --- a/man/ipmi_ui.1 +++ b/man/ipmi_ui.1 @@ -4,7 +4,7 @@ ipmi_ui \- Crude interface to an IPMI system .SH SYNOPSIS -.B ipmiui +.B ipmi_ui .RB [\| \-dmsg \|] .RB [\| \-dmem \|] .RB [\| \-c \|] @@ -34,7 +34,7 @@ Normally, starts up in a full-screen format. The left window shows the output of commands, the right window shows the logs from OpenIPMI. Both windows are scrollable with page up and page down keys, press the "\fBF1\fP" -key to choose the the left window to scroll, the "\fBF2\fP" key to choose +key to choose the left window to scroll, the "\fBF2\fP" key to choose the right window to scroll. Note that you must set your environment \fBTERM\fP variable properly for @@ -48,7 +48,7 @@ the connections are to the same IPMI domain through different management controllers. Also, each LAN connection may have two IP addresses. These are two different addresses to the same management controller. So you may have a total of 4 IP addresses to an IPMI -domain, two management controllers and two IP adresses to each +domain, two management controllers and two IP addresses to each management controller. .SH OPTIONS @@ -174,12 +174,12 @@ turns events on or off from the sensor (\fB0\fP or \fB1\fP). turns scanning on or off for the sensor (\fB0\fP or \fB1\fP). .I "assertion-bitmask" specifies the bitmask of thresholds or states -that should be enabled or disabled when a thrshold or state is +that should be enabled or disabled when a threshold or state is asserted. It is a bunch of 0's and 1's, where the first one is for threshold/state 0, the second for threshold/state 1, etc. .I "deassertion-bitmask" specifies the bitmask of thresholds or states -that should be enabled or disabled when a thrshold or state is +that should be enabled or disabled when a threshold or state is deasserted. .SH CONTROLS diff --git a/man/openipmi_conparms.7 b/man/openipmi_conparms.7 index 587da2a..9dc6404 100644 --- a/man/openipmi_conparms.7 +++ b/man/openipmi_conparms.7 @@ -1,7 +1,7 @@ .TH openipmi_conparms 7 05/13/03 OpenIPMI "Connection Parameters for OpenIPMI" .SH NAME -openipmi_cmdparms \- Connection parmeters for OpenIPMI +openipmi_cmdparms \- Connection parameters for OpenIPMI .SH SYNOPSIS @@ -97,7 +97,7 @@ use. .TP .BI \-Rc\ confidentiality\ algorithm The \fIRMCP+ confidentiality (encryption) algorithm\fP to use. This keeps -evesdroppers from seeing the data. Valid values are: \fBbmcpick\fP, +eavesdroppers from seeing the data. Valid values are: \fBbmcpick\fP, \fBaes_cbc_128\fP, \fBxrc4_128\fP, and \fBxrc_40\fP. The \fBbmcpick\fP option is used by default, which means the BMC picks the algorithm it wants to use. diff --git a/man/openipmicmd.1 b/man/openipmicmd.1 index 6bd2401..5d206d1 100644 --- a/man/openipmicmd.1 +++ b/man/openipmicmd.1 @@ -22,7 +22,7 @@ interfaces. Execute a single command an exit. .TP -.BI +.BI The parameters for the connection depend on the connection type. These are all described in openipmi_conparms (7) @@ -32,7 +32,7 @@ Once up, you can execute commands in the user interface. Note that commands and responses are asynchronous, you issue a command and the interface returns immediately. When the response comes back, it will be dumped on your console. That's a little strange looking, but IPMI -is ansychronous underneath. Note that the \fB\-k\fP option is synchronous, +is asynchronous underneath. Note that the \fB\-k\fP option is synchronous, it will wait for the response or a timeout before returning. .TP @@ -82,7 +82,7 @@ Remove a command registration. .BR openipmi_conparms (7) .SH "KNOWN PROBLEMS" -The asychronous nature of the program can be annoying. +The asynchronous nature of the program can be annoying. .SH AUTHOR .PP diff --git a/man/openipmigui.1 b/man/openipmigui.1 index 04f880b..0c8c10f 100644 --- a/man/openipmigui.1 +++ b/man/openipmigui.1 @@ -38,7 +38,7 @@ Turn on message debugging, this will dump all messages to debug log output. .TP .B \-\-drawmsg Turn on raw message debugging, this will dump all low-level messages to -debug log output. This differes from normal message debugging in that all +debug log output. This differs from normal message debugging in that all protocol messages are also dumped, not just IPMI messages. .TP .B \-\-dmem @@ -81,7 +81,7 @@ tree. The tree window has a top-level list of all the domains for which OpenIPMI has connections (or pending connection). Each domain -exapands into domain-specific information and a list of entities and +expands into domain-specific information and a list of entities and Management Controllers (MCs) for that domain. Right click drives most of the operations in the tree window. Many @@ -92,7 +92,7 @@ Color is used in the GUI to denote error status, and shading is used to denote availability. If a sensor has an error, the tree entry for that sensor will change colors. Black means no error, yellow means warning, red means critical, and blue means non-recoverable. These -errors propigate up, so the entity containing that sensor will be the +errors propagate up, so the entity containing that sensor will be the same color as the most critical error for the sensors underneath it. The same goes for domain, it will be the same color as the most critical error for the entities underneath it. This way, if you watch @@ -146,7 +146,7 @@ that sensor. .SH CONTROLS -Controls are available under the entity they belong to. control +Controls are available under the entity they belong to. Control information is beyond the scope of this document, as IPMI controls are very complex. See the IPMI document from OpenIPMI for information about controls. @@ -214,7 +214,7 @@ channel listing. Note that some user setting (the name and password) are global to all channels on the MC. Due to the IPMI spec and some unfortunate implementation bugs, some -wierd issues exist with this information. The user has an Enabled +weird issues exist with this information. The user has an Enabled value that tells whether the user is enabled or not. When initially displayed, this field shows as a "?" because this field is not readable. It will displayed as the actual value when it is modified, @@ -247,7 +247,7 @@ changed. .SH SOLPARMS In the channel display on a 8023_LAN channel, a LANPARM configuration -command is available if the MC supporte SOL (Serial Over LAN). This +command is available if the MC supports SOL (Serial Over LAN). This pulls up all the parameters for the LAN and allows them to be set. Right-clicking on an item allows it to be changed. diff --git a/man/openipmish.1 b/man/openipmish.1 index 36b1e43..2c902e4 100644 --- a/man/openipmish.1 +++ b/man/openipmish.1 @@ -26,7 +26,7 @@ Turn on message debugging, this will dump all messages to debug log output. .TP .B \-\-drawmsg Turn on raw message debugging, this will dump all low-level messages to -debug log output. This differes from normal message debugging in that all +debug log output. This differs from normal message debugging in that all protocol messages are also dumped, not just IPMI messages. .TP .B \-\-dmem @@ -34,11 +34,21 @@ Turn on memory debugging, this will cause memory allocation and deallocations to be checked. When the program terminates, it will dump all memory that was not properly freed (leaked). .TP +.B \-\-dmsgerr +Turn on printing out low-level message errors. +.TP .B \-\-dlock Turn on lock debugging, this will check lock operations to make sure that locks are help in all the proper places and make sure that locks are properly nested. .TP +\fB-x\fR\ ,\ \fB\-\-execute\fR\ +Execute the given string at startup. This may be entered multiple times +for multiple commands. +.TP +.B \-\-glib +Use glib for the OS handler. +.TP .B \-\-snmp Enable the SNMP trap handler. .B openipmish diff --git a/man/rmcp_ping.1 b/man/rmcp_ping.1 index d60019a..ce5cab0 100644 --- a/man/rmcp_ping.1 +++ b/man/rmcp_ping.1 @@ -38,7 +38,7 @@ starttag. This is zero by default Turns on debugging to standard output. .TP .I destination -The target address, default is the boradcast address (default 255.255.255.255) +The target address, default is the broadcast address (default 255.255.255.255) .SH AUTHOR .PP diff --git a/man/solterm.1 b/man/solterm.1 index 1479a1b..ada15d8 100644 --- a/man/solterm.1 +++ b/man/solterm.1 @@ -37,9 +37,9 @@ These are all described in openipmi_conparms (7) .TP .BI \-e\ escape_char The character to use to escape, or exit, the program. Entering this -chatacter right after a newline is entered causes the program to go +character right after a newline is entered causes the program to go into command mode. A single character after this performs a command. -The default escape character is "~" as shown below. Suppported +The default escape character is "~" as shown below. Supported commands are: .RS .IP ~. @@ -98,7 +98,7 @@ the SoL session. This is the default. .TP .BI \-holdoff Specifies that CTS, DTR, and DSR are to be deasserted at the start of -the SoL session so that the configuration may be modifeid before the +the SoL session so that the configuration may be modified before the handshake is released. .TP diff --git a/sample/ipmicmd.c b/sample/ipmicmd.c index 37fb913..af1ef6b 100644 --- a/sample/ipmicmd.c +++ b/sample/ipmicmd.c @@ -124,6 +124,7 @@ void usage(void) printf("%s [-k ] [-v] \n", progname); printf("Where is one of:"); ipmi_parse_args_iter_help(con_usage, NULL); + printf("\n"); } char * diff --git a/sample/rmcp_ping.c b/sample/rmcp_ping.c index c03fb5e..10a9ca4 100644 --- a/sample/rmcp_ping.c +++ b/sample/rmcp_ping.c @@ -156,6 +156,11 @@ main(int argc, char *argv[]) if (strcmp(argv[i], "--") == 0) { i++; break; + } else if ((strcmp(argv[i], "--help") == 0) || + (strcmp(argv[i], "-?") == 0) || + (strcmp(argv[i], "-h") == 0)) { + i++; + usage(); } else if (strcmp(argv[i], "-p") == 0) { i++; if (i >= argc) { diff --git a/sample/solterm.c b/sample/solterm.c index 8adfb69..966b6ac 100644 --- a/sample/solterm.c +++ b/sample/solterm.c @@ -745,7 +745,12 @@ int main(int argc, char *argv[]) /* Now we make sure "lan" is the first argument so we get the right connection type... */ - if (strcmp(argv[1], "lan") != 0) { + if ((strcmp(argv[1], "-h") == 0) || + (strcmp(argv[1], "--help") == 0) || + (strcmp(argv[1], "-?") == 0)) { + usage(); + exit(1); + } else if (strcmp(argv[1], "lan") != 0) { fprintf(stderr, "main: %s only supports lan connections\n", progname); exit(1); diff --git a/ui/basic_ui.c b/ui/basic_ui.c index 5676ce4..3c10868 100644 --- a/ui/basic_ui.c +++ b/ui/basic_ui.c @@ -306,6 +306,26 @@ snmp_init(os_handler_t *os_hnd) static void snmp_setup_fds(os_handler_t *os_hnd) { } #endif /* HAVE_UCDSNMP */ +void help(void) +{ + fprintf(stdout, "ipmi_ui [ options ] smi smi-num\n"); + fprintf(stdout, "ipmi_ui [ oprions ] lan IP port [IP2 port2] auth priv user pass\n"); + fprintf(stdout, "\n"); + fprintf(stdout, "Options:\n"); + fprintf(stdout, " -c Command line mode\n"); + fprintf(stdout, " -dlock Lock debugging ON\n"); + fprintf(stdout, " -dmem Memory debugging ON\n"); + fprintf(stdout, " -drawmsg Raw message ON\n"); + fprintf(stdout, " -dmsg Dump all messages.\n"); +#ifdef HAVE_UCDSNMP + fprintf(stdout, " -snmp SNMP trap handler ON\n"); +#endif + fprintf(stdout, "Auth:\n"); + fprintf(stdout, " none | straight | md5 | md2\n"); + fprintf(stdout, "Priv:\n"); + fprintf(stdout, " callback | user | operator | admin\n"); +} + int main(int argc, char *argv[]) { @@ -327,6 +347,11 @@ main(int argc, char *argv[]) curr_arg++; if (strcmp(arg, "--") == 0) { break; + } else if (strcmp(arg, "-?") == 0 || + strcmp(arg, "-h") == 0 || + strcmp(arg, "--help") == 0) { + help(); + return(1); } else if (strcmp(arg, "-c") == 0) { full_screen = 0; } else if (strcmp(arg, "-dlock") == 0) { -- 2.20.1