Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / porttime.5
1 '\" t
2 .\"     Title: porttime
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5 .\"      Date: 02/16/2011
6 .\"    Manual: File Formats and Conversions
7 .\"    Source: File Formats and Conversions
8 .\"  Language: English
9 .\"
10 .TH "PORTTIME" "5" "02/16/2011" "File Formats and Conversions" "File Formats and Conversions"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 porttime \- port access time file
32 .SH "DESCRIPTION"
33 .PP
34
35 \fIporttime\fR
36 contains a list of tty devices, user names, and permitted login times\&.
37 .PP
38 Each entry consists of three colon separated fields\&. The first field is a comma separated list of tty devices, or an asterisk to indicate that all tty devices are matched by this entry\&. The second field is a comma separated list of user names, or an asterisk to indicated that all user names are matched by this entry\&. The third field is a comma separated list of permitted access times\&.
39 .PP
40 Each access time entry consists of zero or more days of the week, abbreviated
41 \fISu\fR,
42 \fIMo\fR,
43 \fITu\fR,
44 \fIWe\fR,
45 \fITh\fR,
46 \fIFr\fR, and
47 \fISa\fR, followed by a pair of times separated by a hyphen\&. The abbreviation
48 \fIWk\fR
49 may be used to represent Monday thru Friday, and
50 \fIAl\fR
51 may be used to indicate every day\&. If no days are given,
52 \fIAl\fR
53 is assumed\&.
54 .SH "EXAMPLES"
55 .PP
56 The following entry allows access to user
57 \fBjfh\fR
58 on every port during weekdays from 9am to 5pm\&.
59 .PP
60 *:jfh:Wk0900\-1700
61 .PP
62 The following entries allow access only to the users
63 \fIroot\fR
64 and
65 \fIoper\fR
66 on
67 /dev/console
68 at any time\&. This illustrates how the
69 /etc/porttime
70 file is an ordered list of access times\&. Any other user would match the second entry which does not permit access at any time\&.
71 .sp
72 .if n \{\
73 .RS 4
74 .\}
75 .nf
76       console:root,oper:Al0000\-2400
77       console:*:
78     
79 .fi
80 .if n \{\
81 .RE
82 .\}
83 .PP
84 The following entry allows access for the user
85 \fIgames\fR
86 on any port during non\-working hours\&.
87 .PP
88 *:games:Wk1700\-0900,SaSu0000\-2400
89 .SH "FILES"
90 .PP
91 /etc/porttime
92 .RS 4
93 File containing port access\&.
94 .RE
95 .SH "SEE ALSO"
96 .PP
97
98 \fBlogin\fR(1)\&.