.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "openhpid 8"
.TH openhpid 8 "2020-12-28" "3.8.0" "OpenHPI"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
openhpid \- HPI instance to which multiple clients can connect.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
openhpid \-c config_file [\s-1OPTION\s0]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The OpenHPI daemon runs as a background process and accepts connections from
remote clients that invoke \s-1HPI\s0 function calls. The daemon wraps the OpenHPI
library with a sockets-based \s-1API\s0 that is archicture neutral for all types of
clients.
.PP
When you run the daemon, the standard method for locating the OpenHPI
configuration file is used. However, the daemon will accept a configuration
file as a command line option (\-c) to override the default file.
.PP
A command option (\-p)  or environment variable determines the port number the
daemon will listen on for client connections. The default port is 4743.
.PP
The daemon creates a \s-1PID\s0 file in the /var/run subdirectory. This directory is
only writable by the root user. Thus the daemon will fail when run as a normal
user if the \s-1PID\s0 file location is not overridden.
To override the \s-1PID\s0 file location you can use the \-f command line option.
.PP
The client and the daemon do not have to be on the same hardware architecture.
The daemon could be running on a P\-series processor and the client running on
an x86\-series processor. The client library and daemon use a marshaling
technique to resolve architecture and structure padding conflicts. The user
does not need to concern themselves with architectureal differences between
the client and daemon. The one exception to this rule is 64\-bit architectures.
The client and daemon currently cannot resolve differences between 32\-bit and
64\-bit architectures.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-c\fR, \fB\-\-cfg\fR=\fIconf_file\fR" 4
.IX Item "-c, --cfg=conf_file"
Sets path/name of the configuration file.
This option is required unless the environment 
variable \s-1OPENHPI_CONF\s0 has been set to a valid configuration file.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
This option causes the daemon to display verbose
messages. This option is optional.
.IP "\fB\-b\fR, \fB\-\-bind\fR=\fIbind_address\fR" 4
.IX Item "-b, --bind=bind_address"
Bind address for the daemon socket.
Also bind address can be specified with
\&\s-1OPENHPI_DAEMON_BIND_ADDRESS\s0 environment variable.
No bind address is used by default.
.IP "\fB\-p\fR, \fB\-\-port\fR=\fIport\fR" 4
.IX Item "-p, --port=port"
Overrides the default listening port (4743) of the daemon.
The option is optional.
.IP "\fB\-f\fR, \fB\-\-pidfile\fR=\fIpidfile\fR" 4
.IX Item "-f, --pidfile=pidfile"
Overrides the default path/name for the daemon pid file.
The option is optional.
.IP "\fB\-s\fR, \fB\-\-timeout\fR=\fIseconds\fR" 4
.IX Item "-s, --timeout=seconds"
Overrides the default socket read timeout of 30 minutes.
The option is optional.
.IP "\fB\-t\fR, \fB\-\-threads\fR=\fIthreads\fR" 4
.IX Item "-t, --threads=threads"
Sets the maximum number of connection threads.
The default is umlimited.
The option is optional.
.IP "\fB\-n\fR, \fB\-\-nondaemon\fR" 4
.IX Item "-n, --nondaemon"
Forces the code to run as a foreground process and \s-1NOT\s0 as a daemon.
The default is to run as a daemon.
The option is optional.
.IP "\fB\-6\fR, \fB\-\-ipv6\fR" 4
.IX Item "-6, --ipv6"
The daemon will try to bind IPv6 socket.
.IP "\fB\-4\fR, \fB\-\-ipv4\fR" 4
.IX Item "-4, --ipv4"
The daemon will try to bind IPv4 socket (default).
IPv6 option takes precedence over IPv4 option.
.IP "\fB\-4 \-6\fR" 4
.IX Item "-4 -6"
The daemon will try to bind IPv4 or IPv6 socket.
.SH "ENVIRONMENTAL VARIABLES"
.IX Header "ENVIRONMENTAL VARIABLES"
All of these environment variables can instead be set in the openhpi.conf
configuration file, except for \s-1OPENHPI_DAEMON_PORT\s0 and \s-1OPENHPI_CONF.\s0
.IP "\fB\s-1OPENHPI_DAEMON_PORT\s0\fR=PORT_NUMBER" 4
.IX Item "OPENHPI_DAEMON_PORT=PORT_NUMBER"
The port number the host will listen on for clent connections.
Default port is 4743.
.IP "\fB\s-1OPENHPI_LOG_ON_SEV\s0\fR" 4
.IX Item "OPENHPI_LOG_ON_SEV"
Valus can be one of: \s-1CRITICAL,MAJOR,MINOR,INFORMATIONAL,OK,DEBUG.\s0
Events of this severity or higher will be logged to the domain event log.
The default is \s-1MINOR.\s0
.IP "\fB\s-1OPENHPI_EVT_QUEUE_LIMIT\s0\fR=NUMBER" 4
.IX Item "OPENHPI_EVT_QUEUE_LIMIT=NUMBER"
Maximum number of events allowed in a subscribed session's queue.
Default is 10000.
.IP "\fB\s-1OPENHPI_DEL_SIZE_LIMIT\s0\fR=NUMBER" 4
.IX Item "OPENHPI_DEL_SIZE_LIMIT=NUMBER"
Maximum number of events allowed in the domain event log.
Default is 10000
.IP "\fB\s-1OPENHPI_DEL_SAVE\s0\fR" 4
.IX Item "OPENHPI_DEL_SAVE"
Set to \s-1YES\s0 to persist the domain event logs to disk. They will be loaded
in case the daemon restarts. Default is \s-1NO.\s0
.IP "\fB\s-1OPENHPI_DAT_SIZE_LIMIT\s0\fR=NUMBER" 4
.IX Item "OPENHPI_DAT_SIZE_LIMIT=NUMBER"
Maximum number of alarms allowed in the domain alarm table.
Default is unlimited.
.IP "\fB\s-1OPENHPI_DAT_USER_LIMIT\s0\fR=NUMBER" 4
.IX Item "OPENHPI_DAT_USER_LIMIT=NUMBER"
Maximum number of user alarms allowed in the domain alarm table.
Default is unlimited.
.IP "\fB\s-1OPENHPI_DAT_SAVE\s0\fR" 4
.IX Item "OPENHPI_DAT_SAVE"
Set to \s-1YES\s0 to persist the domain alarm tables to disk. They will be loaded
in case the daemon restarts. Default is \s-1NO.\s0
.ie n .IP "\fB\s-1OPENHPI_PATH\s0\fR=""/path/to/plugins:/another/path/to/plugins""" 4
.el .IP "\fB\s-1OPENHPI_PATH\s0\fR=``/path/to/plugins:/another/path/to/plugins''" 4
.IX Item "OPENHPI_PATH=/path/to/plugins:/another/path/to/plugins"
This is a colon delimited list of directories used when searching for an
OpenHPI plugin to load. The default is \f(CW$prefix\fR/lib/openhpi.
.ie n .IP "\fB\s-1OPENHPI_VARPATH\s0\fR=""/path/to/dir""" 4
.el .IP "\fB\s-1OPENHPI_VARPATH\s0\fR=``/path/to/dir''" 4
.IX Item "OPENHPI_VARPATH=/path/to/dir"
This sets the directory used to store openhpi internal data. The domain
event logs and alarm tables are saved there (if configured to) along with
resource \s-1ID\s0 to entity path mappings.
Default is \f(CW$prefix\fR/var/lib/openhpi.
.ie n .IP "\fB\s-1OPENHPI_CONF\s0\fR=""/path/to/configurationg/file""" 4
.el .IP "\fB\s-1OPENHPI_CONF\s0\fR=``/path/to/configurationg/file''" 4
.IX Item "OPENHPI_CONF=/path/to/configurationg/file"
This is another way of telling the daemon where to find the configuration file.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
The following man pages may also be of interest
.IP "\fBopenhpi\fR" 4
.IX Item "openhpi"
General information about OpenHPI
.SH "AUTHORS"
.IX Header "AUTHORS"
Authors of this man page:
.PP
.Vb 2
\& Renier Morales (renier@openhpi.org)
\& Anton Pak (avpak@users.sourceforge.net)
.Ve