summaryrefslogtreecommitdiff
path: root/doc/iseltime.8
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff.email>2018-08-01 11:19:06 +0200
committerJörg Frings-Fürst <debian@jff.email>2018-08-01 11:19:06 +0200
commitc23016096ab5f8bae409006306e6652e04da030a (patch)
tree255c96d4ea8bd891508720bd98b3b40a4b787459 /doc/iseltime.8
parentc7d4db3862a24474655a43c98572e82503d9fa6b (diff)
parentf3bbd65d98b943e7224be2c1ff242fcf04386701 (diff)
Merge branch 'feature/upstream' into develop
Diffstat (limited to 'doc/iseltime.8')
-rw-r--r--doc/iseltime.868
1 files changed, 35 insertions, 33 deletions
diff --git a/doc/iseltime.8 b/doc/iseltime.8
index eb9a705..1b51f0b 100644
--- a/doc/iseltime.8
+++ b/doc/iseltime.8
@@ -1,53 +1,53 @@
-.TH ISELTIME 8 "Version 1.0: 01 Apr 2013"
+.TH ISELTIME 8 "Version 1.0: 13 Jul 2018"
.SH NAME
-iseltime \- synchronize BMC SEL time with OS system time
+iseltime \- synchronize BIOS RTC and firmware SEL time from system time
.SH SYNOPSIS
-.B "seltime [-sx -NUPRETVF]"
+.B "iseltime [-sx -N node -U user -P/-R pswd -EFJTVYZ]"
.SH DESCRIPTION
-.I seltime
-is a program that uses IPMI commands to
-set the BMC SEL time from the OS system time.
-The OS system time should be in sync with the BIOS Real-Time-Clock.
-The OS system time may also be kept from drifting via an NTP server.
-Normally the BIOS will set the BMC time from the RTC during boot, but
-running this command may be necessary periodically if the system
-does not reboot for many weeks, for instance.
-Note that this command should not be run too frequently to avoid
-BMC timing issues. Once per day should be sufficient.
+.I iseltime
+is a program that allows synchronizing the hardware time values for
+RTC (BIOS Real-Time-Clock) and SEL (IPMI firmware SEL time) with
+the OS system time. Run without options, iseltime shows each of these times
+to show whether they are the same or not.
-Run with no options, this command reads the BMC SEL time without
-setting anything.
-
-This utility can use either the /dev/ipmi0 openipmi driver,
-the /dev/imb Intel driver, the /dev/ipmikcs valinux driver,
-a driverless interface, or IPMI LAN.
+The OS system time should be in sync with the BIOS Real-Time-Clock.
+The OS system time may also be kept from drifting via an NTP server.
+Normally the BIOS will set the firmware SEL time from the RTC during boot,
+but running this command may be necessary periodically if the system does
+not reboot for a long time, for instance.
+Note that some applications may not handle setting the time backward well.
+Note that this command should not be run too frequently to avoid firmware
+timing issues. It should not be set more than once per day.
.SH OPTIONS
-.IP "-s"
-Sets the SEL time (no more than once a day).
+Command line options are described below.
+.IP "-s"
+Set the RTC and IPMI firmware SEL time to match the system time.
+This should not be performed more often than once a day.
+
.IP "-x"
Causes eXtra debug messages to be displayed.
-
.IP "-N nodename"
-Nodename of the remote target system. If a nodename is specified,
-IPMI LAN interface is used. Otherwise the local system management
-interface is used.
-.IP "-P/-R password"
-Remote password for the nodename given. The default is a null password.
-.IP "-U username"
+Nodename or IP address of the remote target system. If a nodename is
+specified, IPMI LAN interface is used. Otherwise the local system
+management interface is used.
+.IP "-U rmt_user"
Remote username for the nodename given. The default is a null username.
+.IP "-P/-R rmt_pswd"
+Remote password for the nodename given. The default is a null password.
.IP "-E"
Use the remote password from Environment variable IPMI_PASSWORD.
.IP "-F drv_t"
-Force the driver type to one of the followng:
+Force the driver type to one of the followng:
imb, va, open, gnu, landesk, lan, lan2, lan2i, kcs, smb.
Note that lan2i means lan2 with intelplus.
The default is to detect any available driver type and use it.
.IP "-J"
-Use the specified LanPlus cipher suite (0 thru 14): 0=none/none/none,
+Use the specified LanPlus cipher suite (0 thru 17): 0=none/none/none,
1=sha1/none/none, 2=sha1/sha1/none, 3=sha1/sha1/cbc128, 4=sha1/sha1/xrc4_128,
5=sha1/sha1/xrc4_40, 6=md5/none/none, ... 14=md5/md5/xrc4_40.
+Default is 3.
.IP "-T"
Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM.
.IP "-V"
@@ -55,16 +55,18 @@ Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Oper
.IP "-Y"
Yes, do prompt the user for the IPMI LAN remote password.
Alternatives for the password are -E or -P.
+.IP "-Z"
+Set the slave address for a local MC
.SH "SEE ALSO"
-ipmiutil(8) isel(8) ievents(8) icmd(8)
+ipmiutil(8) ialarms(8) iconfig(8) icmd(8) idiscover(8) ievents(8) igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8) isol(8) iwdt(8)
.SH WARNINGS
-See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list.
+See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list.
.SH COPYRIGHT
-Copyright (C) 2013 Kontron America, Inc.
+Copyright (C) 2009 Kontron America, Inc.
.PP
See the file COPYING in the distribution for more details
regarding redistribution.