zephyr/clients/zlocate/zlocate.1

   1 .\"     $Id$
   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 ZLOCATE 1 "April 17, 1990" "MIT Project Athena"
   9 .ds ]W MIT Project Athena
  10 .SH NAME
  11 zlocate \- find a user using Zephyr
  12 .SH SYNOPSIS
  13 .B zlocate
  14 [
  15 .B -a
  16 |
  17 .B -d
  18 ] user ...
  19 .SH DESCRIPTION
  20 .I Zlocate
  21 uses the
  22 .I Zephyr(1)
  23 Notification Service to find where a user is currently logged in.  If
  24 the user is not logged in, or has set his location information such that
  25 you do not have access to see it,
  26 .I zlocate
  27 prints "Hidden or not logged-in".  Otherwise, each machine that the
  28 user is currently logged into is printed, along with the time of
  29 login and location.  The location is usually the X window system display
  30 name of the user's display, but may be the terminal name if he is not
  31 using X or for some other reason is only using the terminal interface to
  32 .I zwgc(1).
  33
  34 By default, all zlocate requests are authenticated using
  35 .IR Kerberos .
  36 If you do not have kerberos tickets, or for some other reason do not
  37 want to authenticate, the
  38 .B -d
  39 option will turn off authentication.  The
  40 .B -a
  41 option is the default, authentication on.
  42
  43 .SH DIAGNOSTICS
  44 .I zlocate
  45 exits with status zero (0) if at least one user was found, and one (1)
  46 if no users were found.
  47 .SH SEE ALSO
  48 zctl(1), zephyr(1), znol(1), zwgc(1), zhm(8), zephyrd(8), X(1)
  49 .br
  50 Project Athena Technical Plan Section E.4.1, `Zephyr Notification
  51 Service'
  52 .SH AUTHORS
  53 .PP
  54 Robert S. French (MIT-Project Athena)
  55 .br
  56 Marc Horowitz (MIT-Project Athena)
  57 .SH RESTRICTIONS
  58 Copyright (c) 1987,1988 by the Massachusetts Institute of Technology.
  59 All Rights Reserved.
  60 .br
  61 .I zephyr(1)
  62 specifies the terms and conditions for redistribution.