zhm/zhm.8

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