documented fixed and conditional defaults. adjusted synopsis

This commit is contained in:
Ales Ledvinka 2012-12-12 02:33:58 +01:00
parent a9fc0182f4
commit 2d27c20e98
2 changed files with 170 additions and 1 deletions

View File

@ -0,0 +1,163 @@
diff -up ./ipmitool.1.manover ./ipmitool.1
--- doc/ipmitool.1.manover 2012-12-12 02:04:40.870399182 +0100
+++ doc/ipmitool.1 2012-12-12 02:25:08.368992981 +0100
@@ -2,38 +2,57 @@
.SH "NAME"
ipmitool \- utility for controlling IPMI\-enabled devices
.SH "SYNOPSIS"
-ipmitool [\fB\-c\fR|\fB\-h\fR|\fB\-d \fIN\fP\fR|\fB\-v\fR|\fB\-V\fR]
-\fB\-I\fR \fIopen\fP <\fIcommand\fP>
-ipmitool [\fB\-c\fR|\fB\-h\fR|\fB\-v\fR|\fB\-V\fR]
-\fB\-I\fR \fIlan\fP \fB\-H\fR <\fIhostname\fP>
- [\fB\-p\fR <\fIport\fP>]
- [\fB\-U\fR <\fIusername\fP>]
- [\fB\-A\fR <\fIauthtype\fP>]
- [\fB\-L\fR <\fIprivlvl\fP>]
- [\fB\-a\fR|\fB\-E\fR|\fB\-P\fR|\fB\-f\fR <\fIpassword\fP>]
- [\fB\-o\fR <\fIoemtype\fP>]
- [\fB\-O\fR <\fIsel oem\fP>]
- [\fB\-e\fR <\fIesc_char\fP>]
- [\fB\-N\fR <\fIsec\fP>]
- [\fB\-R\fR <\fIcount\fP>]
- <\fIcommand\fP>
-
-ipmitool [\fB\-c\fR|\fB\-h\fR|\fB\-v\fR|\fB\-V\fR]
-\fB\-I\fR \fIlanplus\fP \fB\-H\fR <\fIhostname\fP>
- [\fB\-p\fR <\fIport\fP>]
- [\fB\-U\fR <\fIusername\fP>]
- [\fB\-L\fR <\fIprivlvl\fP>]
- [\fB\-a\fR|\fB\-E\fR|\fB\-P\fR|\fB\-f\fR <\fIpassword\fP>]
- [\fB\-o\fR <\fIoemtype\fP>]
- [\fB\-O\fR <\fIsel oem\fP>]
- [\fB\-C\fR <\fIciphersuite\fP>]
- [\fB\-Y\fR|[\fB\-K\fR|\fB\-k\fR <\fIkg_key\fP>]
- [\fB\-y\fR <\fIhex_kg_key\fP>]
- [\fB\-e\fR <\fIesc_char\fP>]
- [\fB\-N\fR <\fIsec\fP>]
- [\fB\-R\fR <\fIcount\fP>]
- <\fIcommand\fP>
+ipmitool [ <options> ] <command> [ <sub-commands and sub-options> ]
+
+<options> := [ <general-options> | <conditional-opts> ]
+.br
+Any recognized option is accepted. Conditional options may be ignored or it's usage postponed until shell or exec processes relevant command.
+.br
+
+<general-options> := [ -h | -V | -v | -I <interface> | -H <address> |
+ -d <N> | -p <port> | -c | -U <username> |
+ -L <privlvl> | -l <lun> | -m <local_address> |
+ -N <sec> | -R <count> | <password-option> |
+ <oem-option> | <bridge-options> ]
+
+<conditional-opts> := [ <lan-options> | <lanplus-options> |
+ <command-options> ]
+.br
+Bridging:
+.br
+<bridge-options> := -t <target_address> [ -b <channel> |
+ [ -T <address> | -B <channel> ] ]
+.br
+
+Options used with -I lan:
+.br
+<lan-options> := [ -A <authtype> ]
+.br
+
+Options used with -I lanplus:
+.br
+<lanplus-options> := [ -C <ciphersuite> | <key-option> ]
+.br
+
+Option groups setting same value:
+.br
+<key-option> := [ -k <key> | -K | -y <hex_key> | -Y ]
+.br
+<password-option> := [ -f <password_file> | -a | -P <password> | -E ]
+.br
+<oem-option> := [ -o <oemtype> | -g | -s ]
+.br
+
+Options used with specific command <command-options>:
+.br
+<options-sdr> := [ -S <sdr_cache_file> ]
+.br
+<options-sel> := [ -O <sel_oem> ]
+.br
+<options-sol> := [ -e <sol_escape_char> ]
+
+
.SH "DESCRIPTION"
This program lets you manage Intelligent Platform Management Interface
(IPMI) functions of either the local system, via a kernel device driver,
@@ -87,7 +106,7 @@ is to use \fI~\fP but this can conflict
.TP
\fB\-E\fR
The remote server password is specified by the environment
-variable \fIIPMI_PASSWORD\fP.
+variable \fIIPMI_PASSWORD\fP or \fIIPMITOOL_PASSWORD\fP. The \fIIPMITOOL_PASSWORD\fP takes precedence.
.TP
\fB\-f\fR <\fIpassword_file\fP>
Specifies a file containing the remote server password. If this
@@ -121,6 +140,8 @@ Set destination lun for raw commands.
\fB\-L\fR <\fIprivlvl\fP>
Force session privilege level. Can be CALLBACK, USER,
OPERATOR, ADMINISTRATOR. Default is ADMINISTRATOR.
+This value is ignored and always set to ADMINISTRATOR when
+combined with \fI-t target address\fP.
.TP
\fB\-m\fR <\fIlocal_address\fP>
Set the local IPMB address. The default is 0x20 and there
@@ -131,7 +152,9 @@ Set transit local address for bridge req
.TP
\fB\-N\fR <\fIsec\fP>
Specify nr. of seconds between retransmissions of lan/lanplus messages.
-Default are 2 seconds for lan and 1 second for lanplus interfaces.
+Defaults are 2 seconds for lan and 1 second for lanplus interfaces.
+Command \fIraw\fP uses fixed value of 15 seconds.
+Command \fIsol\fP uses fixed value of 1 second.
.TP
\fB\-o\fR <\fIoemtype\fP>
Select OEM type to support. This usually involves minor hacks
@@ -154,6 +177,8 @@ option is not recommended.
.TP
\fB\-R\fR <\fIcount\fP>
Set the number of retries for lan/lanplus interface (default=4).
+Command \fIraw\fP uses fixed value of one try (no retries).
+Command \fIhpm\fP uses fixed value of 10 retries.
.TP
\fB\-s\fR
Deprecated. Use: -o supermicro
@@ -166,7 +191,8 @@ SDR cache from a remote system can be cr
\fIsdr dump\fP command.
.TP
\fB\-t\fR <\fItarget_address\fP>
-Bridge IPMI requests to the remote target address.
+Bridge IPMI requests to the remote target address. Default is 32.
+The \fI-L privlvl\fP option is always ignored and value set to ADMINISTRATOR.
.TP
\fB\-T\fR <\fItransmit_address\fP>
Set transit address for bridge request. (dual bridge)
@@ -178,7 +204,11 @@ Remote server username, default is NULL
Increase verbose output level. This option may be specified
multiple times to increase the level of debug output. If given
three times you will get hexdumps of all incoming and
-outgoing packets.
+outgoing packets. Using it five times provides details
+on request and expected reply procesing. The \fIhpm\fP commands
+\fItargetcap\fP \fIcompprop\fP \fIabort\fP \fIupgstatus\fP
+\fIrollback\fP \fIrollbackstatus\fP \fIselftestresult\fP increases
+the verbosity level
.TP
\fB\-V\fR
Display version information.
@@ -2758,6 +2788,9 @@ Remote RMCP port.
\fIcsv\fP [\fBlevel\fR]
Enable output in comma separated format.
+Affects following commands:
+\fIuser\fP, \fIchannel\fP, \fIisol\fP, \fIsunoem\fP,
+\fIsol\fP, \fIsensor\fP, \fIsdr\fP, \fIsel\fP, \fIsession\fP.
.RS
.RE
.TP

View File

@ -1,7 +1,7 @@
Name: ipmitool
Summary: Utility for IPMI control
Version: 1.8.12
Release: 8%{?dist}
Release: 10%{?dist}
License: BSD
Group: System Environment/Base
URL: http://ipmitool.sourceforge.net/
@ -38,6 +38,8 @@ Patch8: ipmitool-1.8.12-ciper-suite-default.patch
Patch9: ipmitool-1.8.12-activate-core.patch
# todo
Patch10: ipmitool-1.8.12f-toolman.patch
# todo
Patch11: ipmitool-1.8.12f-manoverr.patch
%description
This package contains a utility for interfacing with devices that support
@ -67,6 +69,7 @@ setting LAN configuration, and chassis power control.
%patch8 -p1 -b .cip
%patch9 -p1 -b .noactivate
%patch10 -p1 -b .toolman
%patch11 -p0 -b .manoverr
for f in AUTHORS ChangeLog; do
iconv -f iso-8859-1 -t utf8 < ${f} > ${f}.utf8
@ -132,6 +135,9 @@ install -Dm 755 %{SOURCE6} %{buildroot}%{_libexecdir}/exchange-bmc-os-info
%changelog
* Wed Dec 12 2012 Ales Ledvinka <aledvink@redhat.com> 1.8.12-10
- documented fixed and conditional defaults. adjusted synopsis
* Tue Dec 4 2012 Ales Ledvinka <aledvink@redhat.com> 1.8.12-9
- fixed ipmitool documentation