1 | .\" $Source: /afs/dev.mit.edu/source/repository/athena/bin/session/session_gate.1,v $ |
---|
2 | .\" $Header: /afs/dev.mit.edu/source/repository/athena/bin/session/session_gate.1,v 1.1 1990-11-30 17:57:29 probe Exp $ |
---|
3 | .\" $Author: probe $ |
---|
4 | .\" |
---|
5 | .TH SESSION_GATE 1 "5 August 1989" |
---|
6 | .ds ]W MIT Project Athena |
---|
7 | .SH NAME |
---|
8 | session_gate, end_session \- control lifetime of a session |
---|
9 | |
---|
10 | .SH SYNOPSIS |
---|
11 | .nf |
---|
12 | session_gate |
---|
13 | end_session [ -force | -f ] |
---|
14 | .fi |
---|
15 | .SH DESCRIPTION |
---|
16 | |
---|
17 | \fISession_gate\fR is a process that has the sole purpose of preventing a |
---|
18 | session file from exiting. Normally, \fIsession_gate\fR appears at or near |
---|
19 | the end of a session file used by \fIxlogin\fR(1). When used in this |
---|
20 | fashion, \fIsession_gate\fR should not be run in the background. |
---|
21 | |
---|
22 | \fIEnd_session\fR is a command that attempts to send a hangup signal to |
---|
23 | each \fIsession_gate\fR process that is running. Normally, the user |
---|
24 | invokes \fIend_session\fR to indicate that the current session is to be |
---|
25 | terminated. The \fIlogout\fR can be aliased (in the shell) to invoke |
---|
26 | \fIend_session\fR, for example. |
---|
27 | |
---|
28 | \fIEnd_session\fR determines the process id of each \fIsession_gate\fR |
---|
29 | process by reading the file /tmp/session_gate_pid.\fIuid\fR, where |
---|
30 | \fIuid\fR is the user's uid number. If the \fI-force\fR or \fI-f\fR option |
---|
31 | is specified, then a combination of \fIps\fR(1) and \fIawk\fR(1) is used |
---|
32 | for determining the process id's. |
---|
33 | |
---|
34 | .SH DIAGNOSTICS |
---|
35 | |
---|
36 | \fISession_gate\fR always exits with status 0. |
---|
37 | |
---|
38 | \fIEnd_session\fR will exit with one of the following status values: |
---|
39 | .TP 5 |
---|
40 | 0 |
---|
41 | No error encountered. |
---|
42 | .TP 5 |
---|
43 | 1 |
---|
44 | Bad arguments. |
---|
45 | .TP 5 |
---|
46 | 2 |
---|
47 | No \fIsession_gate\fR processes found (\fI-force\fR or \fI-f\fR option). |
---|
48 | .TP 5 |
---|
49 | 3 |
---|
50 | The file /tmp/session_gate_pid.\fIuid\fR does not exist or is not readable. |
---|
51 | .TP 5 |
---|
52 | 4 |
---|
53 | The file /tmp/session_gate_pid.\fIuid\fR has been modified. |
---|
54 | .PP |
---|
55 | |
---|
56 | .SH FILES |
---|
57 | /tmp/session_gate_pid.\fIuid\fR |
---|
58 | |
---|
59 | .SH "SEE ALSO" |
---|
60 | \fIxlogin\fR(1) |
---|
61 | |
---|
62 | .SH AUTHOR |
---|
63 | .nf |
---|
64 | David J Flanagan, John E Elsbree |
---|
65 | MIT Project Athena |
---|
66 | Copyright 1989, Massachusetts Institute of Technology |
---|
67 | .fi |
---|
68 | |
---|
69 | .SH BUGS |
---|
70 | The \fI-force\fR (\fI-f\fR) option is, admittedly, a kludge. It is very |
---|
71 | dependent on the format of the output produced by \fIps\fR(1). |
---|