zephyr/clients/znol/znol.1

   1 .\"     $Id: znol.1,v 1.9 1999/01/22 23:18:41 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 .\"     @(#)znol.1      6.1 (MIT) 7/9/87
   8 .\"
   9 .TH ZNOL 1 "July 1, 1988" "MIT Project Athena"
  10 .ds ]W MIT Project Athena
  11 .SH NAME
  12 znol \- notify via Zephyr upon login or logout of interesting people
  13 .SH SYNOPSIS
  14 .B znol
  15 [
  16 .BI on|off
  17 ] [
  18 .BI \-f \ file
  19 ] [
  20 .BI \-u \ username
  21 ] [
  22 .BI \-l
  23 ] [
  24 .BI \-q
  25 ]
  26 .SH DESCRIPTION
  27 .I Znol
  28 provides a way for you to be notified when "interesting" people log in
  29 or out.  It uses the
  30 .I Zephyr(1)
  31 Notification Service, which causes a message to appear on your screen
  32 for every person specified in a namelist (which defaults to
  33 $HOME/.anyone).  The namelist should have one login name per line.  Any
  34 line starting with `#' is considered a comment and ignored.
  35 Anyone in the namelist who is logged in when
  36 .I znol
  37 is executed is printed to stdout.  The control arguments are as
  38 follows:
  39 .TP 12
  40 .B on|off
  41 Turns notification on or off.
  42 .TP
  43 .B \-f
  44 The namelist file is taken to be
  45 .I file.
  46 If
  47 .I file
  48 is "-", then the standard input is used instead of a file. If
  49 .I file
  50 does not exist, an error message is printed, and
  51 .I znol
  52 exits.
  53 This option may not be used in conjunction with the
  54 .B \-u
  55 option.
  56 .TP
  57 .B \-l
  58 Causes
  59 .I znol
  60 to just list the people in the namelist who are currently logged in,
  61 without subscribing to the login messages.   This option may not be used
  62 in conjunction with the
  63 .BI \-q
  64 option.
  65 .TP
  66 .B \-q
  67 Disables printing who is currently logged in when subscribing.  This
  68 option may not be used in conjunction with the
  69 .BI \-l
  70 option.
  71 .TP
  72 .B \-u
  73 Instead of reading a file to specify the "interesting" users, the next
  74 argument is used as the only "interesting" user.  This option may not be
  75 used in conjunction with the
  76 .B \-f
  77 option.
  78 .SH EXAMPLES
  79 .nf
  80 .in +.5in
  81 znol
  82 .in -.5in
  83 .fi
  84 reads the standard namelist file, prints the locations of any users
  85 named therein which can be found on the system, and enters subscriptions
  86 for notices about those users.
  87 .nf
  88 .in +.5in
  89 znol -l -u foo
  90 .in -.5in
  91 .fi
  92 prints the location (if visible) of the user 'foo'.
  93 .SH FILES
  94 $HOME/.anyone
  95 .SH SEE ALSO
  96 anyone(SIPB), nol(SIPB), zctl(1), zephyr(1), zwgc(1), zhm(8), zephyrd(8)
  97 .br
  98 Project Athena Technical Plan Section E.4.1, `Zephyr Notification
  99 Service'
 100 .SH AUTHOR
 101 .PP
 102 Robert S. French (MIT-Project Athena)
 103 .sp
 104 .SH RESTRICTIONS
 105 Copyright (c) 1987,1988 by the Massachusetts Institute of Technology.
 106 All Rights Reserved.
 107 .br
 108 .I zephyr(1)
 109 specifies the terms and conditions for redistribution.