summaryrefslogtreecommitdiff
path: root/zhm/zhm.8.in
blob: 15961ddc622c01fe7d269aca8a936bb1886cded1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
.\"	$Id$
.\"
.\" Copyright 1987, 1988 by the Massachusetts Institute of Technology
.\" All rights reserved.  The file /usr/include/zephyr/mit-copyright.h
.\" specifies the terms and conditions for redistribution.
.\"
.\"
.TH ZHM 8 "November 1, 1988" "MIT Project Athena"
.ds ]W MIT Project Athena
.SH NAME
zhm \- Zephyr HostManager
.SH SYNOPSIS
.B @lsbindir@/zhm
[
.BI -d
] [
.BI -n
] [
.BI -h
] [
.BI -r
] [
.BI -i
] [
.BI -f
] [
.BI -N
] [
.BI server
.BI ...
]
.SH DESCRIPTION
.I Zhm
is the link between a client machine and the zephyr server.  All
notices sent from programs on the client are funneled through
.I zhm.
This allows all client programs to be much simpler in function, since
the HostManager is responsible for handling errors, retransmitting
lost notices, and holding all notices until they are acknowledged.
.PP
The
.I -d
option turns on debugging mode, and sends its information to syslog
LOG_DAEMON messages.
.PP
The
.I -n
option causes zhm to not attempt to put itself in the background.
.PP
The
.I -h
option causes
.I zhm
to send a shutdown message and exit upon delivery of a SIGHUP signal.
The normal action on SIGHUP is to send a flush notice to the zephyr server.
.PP
The
.I -r
option causes
.I zhm
to send a boot notice to the server and exit when the notice is acknowledged.
.PP
The
.I -i
option indicates that
.I zhm
is being started by
.I inetd(8).
When this option is specified,
.I zhm
assumes that file descriptor zero (0) is bound to the UDP datagram port
designated for hostmanager use.  In this mode, SIGHUP is handled as if the
.I -h
option were specified.
.PP
The
.I -f
option disables the "flush" operation which allows any client to flush
all subscriptions for the host.
.PP
The
.I -N
option supresses the initial "boot" message that flushes all subscriptions
for the host, which is useful if you're restarting zhm on a host that
people are using.
.PP
The optional
.I server
arguments are used to replace the set of server names supplied by
the
.I hesiod(3)
name server.
.SH SEE ALSO
zephyr(1), zephyrd(8), inetd(8)
.br
Project Athena Technical Plan Section E.4.1, `Zephyr Notification
Service'
.SH AUTHOR
.PP
David C. Jedlinsky, MIT Project Athena
.SH RESTRICTIONS
Copyright (c) 1987,1988 by the Massachusetts Institute of Technology.
All Rights Reserved.
.br
.I zephyr(1)
specifies the terms and conditions for redistribution.