zephyr(1) [debian man page]
ZEPHYR(1) General Commands Manual ZEPHYR(1) NAME
zephyr - Zephyr Notification Service DESCRIPTION
Zephyr is a notice transport and delivery system developed at MIT which runs under 4.3BSD Unix. A Notice Transport and Delivery system is a method of getting small quantities of time sensitive information efficiently from one client (or server) on a network to another. The object is to accomplish this with the highest possible fan-out (i.e., client to server ratio) while maintaining both network and server performance. Zephyr is a multi-cast notice transport and delivery system based upon an authenti- cated datagram protocol. Localized Zephyr servers provide routing, queueing and dispatching services to clients which communicate with them via the Zephyr Client Library. Two special purpose Zephyr clients, the WindowGram client and the HostManager client provide user and client host communication support. Zephyrd(8) servers run on designated server machines. These servers maintain a database of subscriptions and locations for every user using Zephyr. The servers stay in contact with one another, and provide a reliable backup system (via duplication) in the event of network failures. Each client machine on the network runs a zhm(8) HostManager client program which is the link between the Zephyr servers and the users. User programs send notices to the HostManager, and the HostManager forwards these notices to the nearest server for action. The HostMan- ager is responsible for ensuring that the notices reach a server, and for finding a new one if its server fails to respond. Each user on the network usually runs a WindowGram client program automatically upon login. Zwgc(1) displays notices to the user, and han- dles user responses. Only notices to which the user has subscribed will be sent to the WindowGram client. Subscriptions are handled through the zctl(1) program. This program allows the user to add or delete subscriptions from Zephyr, to add the subscriptions to a file, and to perform other miscellaneous functions. SEE ALSO
kerberosintro(1) zaway(1), zctl(1), zleave(1), zlocate(1), znol(1), zwgc(1), zwrite(1), zmailnotify(1) zhm(8), zephyrd(8), zinit(8), zstat(8), zpopnotify(8), zshutdown_notify(8), syslogd(8) Project Athena Technical Plan Section E.4.1, `Zephyr Notification Service' AUTHORS
Tony Della Fera (MIT-Project Athena, DEC), Mark W. Eichin (MIT-Project Athena), Robert S. French (MIT-Project Athena), David C. Jedlinsky (MIT-Project Athena), John T. Kohl (MIT-Project Athena, DEC), William E. Sommerfeld (MIT-Project Athena). RESTRICTIONS
Copyright (c) 1987,1988,1989 by the Massachusetts Institute of Technology. All Rights Reserved. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, pro- vided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in sup- porting documentation, and that the name of the Massachusetts Institute of Technology not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. M.I.T. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL M.I.T. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. MIT Project Athena July 1, 1988 ZEPHYR(1)
Check Out this Related Man Page
ZCTL(1) General Commands Manual ZCTL(1) NAME
zctl - zephyr control program SYNOPSIS
zctl [ options ] DESCRIPTION
Zctl is a general purpose control program for the Zephyr(1) Notification Service. It allows the user to subscribe to specific notice types, to save the subscriptions in a file (default $HOME/.zephyr.subs), to change his location information, and to send control messages to the HostManager, zhm(8), and the WindowGram client, zwgc(1). The commands may be typed on the command line, or may be entered interactively by just typing zctl and then typing commands to the prompt. NOTE: For all commands accepting an optional recipient argument, the recipient defaults to your Kerberos principal. You may also subscribe to recipient ``*''. If you specify a recipient, it is silently converted to ``*''. The commands are as follows: add class instance [ recipient ] Subscribe to class, instance, recipient, and add this triplet to the subscriptions file. add_unsubscription class instance [ recipient ] Unsubscribe to class, instance, recipient, and add this triplet to the subscriptions file as an un-subscription. For an explanation of un-subscriptions, see below. cancel Cancel all subscriptions. defaults Retrieve the default subscription list from the Zephyr server. delete class instance [ recipient ] Unsubscribe to class, instance, recipient, and remove this triplet from the subscriptions file. delete_unsubscription class instance [ recipient ] Unsubscribe to class, instance, recipient, and remove this triplet from the subscriptions file as an un-subscription. file [ file ] Set default subscriptions file to file. If file isn't specified, show what the current subscriptions file is. flush_locs Tell the Zephyr servers to flush all location information associated with the user. This should only be used to remove any incorrect data that may have been left after a system crash. hide Hide your location as maintained by the Zephyr server. This does not affect the value of the exposure variable (see below, under set). hm_flush Tell the HostManager, zhm(8), to ask the server to flush all state associated with the current host. list [ file ] List contents of current subscriptions file or file. Any macros in the file (see below) are displayed verbatim and not expanded. list_requests List all available commands. May be abbreviated by '?'. load [ file ] Subscribe to all subscription triplets and unsubscribe to all un-subscription triplets in current subscriptions file or file. new_server Tell the HostManager, zhm(8), to find a new Zephyr server. quit Exit from zctl. retrieve Retrieve all current subscriptions from the Zephyr server. These include subscriptions that might have been made by other programs, such as znol(1). save [ file ] Save all current subscriptions (as returned by the Zephyr server) into current subscriptions file or file. The file will be replaced. set var [ value ] Set the value of Zephyr variable var to value, or null if no value is specified. The variable exposure has special signifi- cance, and can only be set to the values none, opstaff, realm-visible, realm-announced, net-visible, and net-announced. Setting this variable immediately updates the information in the Zephyr servers (see below for an explanation of the expo- sure levels). In addition, setting this variable to none automatically performs the equivalent of a wg_shutdown command, and setting it to one of the other values automatically performs the equivalent of a wg_startup command. The variable resolved_addresses determines whether zwgc will, for an IP address indicating the origin of a message, attempt to look up the hostname corresponding to that IP address. The value none indicates that hostnames will never be found, and that the zwgc fromhost variable will thus always contain an IP address (in dotted-decimal form). The value all indicates that there will always be an attempt to look up a hostname. Note that in this case, if you have any subscriptions with recipient ``*'', these subscriptions may be revealed to other Zephyr users who operate their own DNS name servers. Any other value is interpreted as a regular expression; hostname lookup attempts will occur only if the IP address matches this regu- lar expression. Any variable settings you make will be stored in $HOME/.zephyr.vars show var [ var ... ] Show the value of the specified Zephyr variables. If a variable is not defined in the user's own variables file, the system variables file (/etc/athena/zephyr.vars) is searched for a default value. subscribe class instance [ recipient ] Subscribe to class, instance, recipient, but don't add this triplet to the subscriptions file. unhide Make your location as maintained by the Zephyr server visible. This does not affect the value of the exposure variable. unload [ file ] Unsubscribe to all subscription triplets in current subscriptions file or file. Un-subscriptions in the file are ignored. unset var [ var ... ] Delete the definitions of the specified Zephyr variables. unsubscribe class instance [ recipient ] Unsubscribe to class, instance, recipient, but don't remove this triplet from the subscriptions file. wg_exit Tell the WindowGram client, zwgc(1), to exit. wg_read Tell the WindowGram client, zwgc(1), to reread its description file. wg_shutdown Tell the WindowGram client to shutdown; this causes it to ignore all notices until a wg_startup command is issued. wg_startup Tell the WindowGram client to start accepting notices again; useful after a wg_shutdown command has been issued. MACROS and SUBSCRIPTION FILES There are three macros, %host%, %canon%, and %me%. %host% is converted to the current hostname, %canon% is converted to the official host- name as returned by gethostbyname(3), and %me% is converted to your Kerberos principal. These macros can be used in your $HOME/.zephyr.subs file or as arguments to commands to specify the class or instance fields. A sample $HOME/.zephyr.subs file might con- tain the following: message,urgent,%me% syslog,%host%,* mail,pop,%me% Zctl reads the environment variable WGFILE, to find the name of the file where the windowgram port resides. If WGFILE is not set, the file name defaults to /tmp/wg.uid, where uid is the user's UNIX uid. UN-SUBSCRIPTIONS The zephyr server, zephyrd(8), maintains default subscriptions which are automatically added to all users' subscriptions at the time of their first subscription during a login session. If you wish to automatically remove some of these default subscriptions, you use un-sub- scriptions. When you load a subscription file containing un-subscriptions, the un-subscriptions are automatically sent to the server as if you had used the unsubscribe command. EXPOSURE LEVELS
The different exposure levels affect the operation of zephyr and its interaction with the user, as follows: none This completely disables Zephyr for the user. The user is not registered with Zephyr. No user location information is retained by Zephyr. No login or logout announcements will be sent. No subscriptions will be entered for the user, and no notices will be displayed by zwgc(1). opstaff The user is registered with Zephyr. No login or logout announcements will be sent, and location information will only be visible to Operations staff. Default subscriptions and any additional personal subscriptions will be entered for the user. realm-visible The user is registered with Zephyr. User location information is retained by Zephyr and made available only to users within the user's Kerberos realm. No login or logout announcements will be sent. This is the system default. Default subscriptions and any additional personal subscriptions will be entered for the user. realm-announced The user is registered with Zephyr. User location information is retained by Zephyr and made available only to users authenti- cated within the user's Kerberos realm. Login and logout announcements will be sent, but only to users within the user's Ker- beros realm who have explicitly requested such via subscriptions. Default subscriptions and any additional personal subscrip- tions will be entered for the user. net-visible The user is registered with Zephyr. User location information is retained by Zephyr and made available to any authenticated user who requests such. Login and logout announcements will be sent only to users within the user's Kerberos realm who have explicitly requested such via subscriptions. Default subscriptions and any additional personal subscriptions will be entered for the user. net-announced The user is registered with Zephyr. User location information is retained by Zephyr and made available to any authenticated user who requests such. Login and logout announcements will be sent to any user has requested such. Default subscriptions and any additional personal subscriptions will be entered for the user. EXAMPLES
zctl Runs zctl in interactive mode. zctl load Load subscriptions and un-subscriptions from $HOME/.zephyr.subs file. zctl sub message personal Subscribe to personal messages, but don't add this to the subscriptions file. zctl save Save all current subscriptions to the default subscriptions file. zctl set exposure none Set your exposure level to `none', effectively turning off Zephyr. SEE ALSO
zephyr(1), zwgc(1), zhm(8), zephyrd(8) gethostbyname(3) Project Athena Technical Plan Section E.4.1, `Zephyr Notification Service' FILES
/tmp/wg.* $HOME/.zephyr.subs $ZEPHYR_VARS or $HOME/.zephyr.vars /etc/athena/zephyr.vars AUTHOR
Robert S. French (MIT-Project Athena) RESTRICTIONS
Copyright (c) 1987,1988 by the Massachusetts Institute of Technology. All Rights Reserved. zephyr(1) specifies the terms and conditions for redistribution. MIT Project Athena July 1, 1988 ZCTL(1)