summaryrefslogtreecommitdiff
path: root/clients/zlocate/zlocate.1
blob: 03819664b8ce9f2f0c2355c132fdd7875e4960af (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
.\"	$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 ZLOCATE 1 "April 17, 1990" "MIT Project Athena"
.ds ]W MIT Project Athena
.SH NAME
zlocate \- find a user using Zephyr
.SH SYNOPSIS
.B zlocate
[
.B -a
| 
.B -d
] [
.B -1
] [
.B -p
] user ...
.SH DESCRIPTION
.I Zlocate
uses the
.I Zephyr(1)
Notification Service to find where a user is currently logged in.  If
the user is not logged in, or has set his location information such that
you do not have access to see it,
.I zlocate
prints "Hidden or not logged-in".  Otherwise, each machine that the
user is currently logged into is printed, along with the time of
login and location.  The location is usually the X window system display
name of the user's display, but may be the terminal name if he is not
using X or for some other reason is only using the terminal interface to
.I zwgc(1).

By default, all zlocate requests are authenticated using
.IR Kerberos .
If you do not have Kerberos tickets, or for some other reason do not
want to authenticate, the
.B -d
option will turn off authentication.  The
.B -a
option is the default, authentication on.

When locating multiple users,
.I zlocate
will display the user name on a line by itself, followed by the locations for that user. To display the user name on the same line as the output, use the
.B -1
option (the numeral one).

To look up multiple users in parallel asynchronously, use the
.B -p
option.

.SH DIAGNOSTICS
.I zlocate
exits with status zero (0) if at least one user was found, and one (1)
if no users were found.
.SH SEE ALSO
zctl(1), zephyr(1), znol(1), zwgc(1), zhm(8), zephyrd(8), X(1)
.br
Project Athena Technical Plan Section E.4.1, `Zephyr Notification
Service'
.SH AUTHORS
.PP
Robert S. French (MIT-Project Athena)
.br
Marc Horowitz (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.