annotate kpathsea/access.man @ 4337:d56e0d75e7c9 ss-2-1-45

[project @ 2003-02-19 21:20:19 by jwe]
author jwe
date Wed, 19 Feb 2003 21:20:19 +0000
parents 1f0b06020e36
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3172
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
1 .TH ACCESS 1 "4 January 1998" "Kpathsea @VERSION@"
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
2 .\"=====================================================================
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
3 .if n .ds MP MetaPost
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
4 .if t .ds MP MetaPost
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
5 .if n .ds MF Metafont
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
6 .if t .ds MF M\s-2ETAFONT\s0
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
7 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
8 .if n .ds TX TeX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
9 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
10 .el .ds OX TeX\" for nroff
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
11 .\" the same but obliqued
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
12 .\" BX definition must follow TX so BX can use TX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
13 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
14 .if n .ds BX BibTeX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
15 .\" LX definition must follow TX so LX can use TX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
16 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
17 .if n .ds LX LaTeX
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
18 .\"=====================================================================
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
19 .SH NAME
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
20 access \- determine whether a file can be accessed
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
21 .SH SYNOPSIS
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
22 .B access
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
23 .I -mode
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
24 .I file
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
25 .\"=====================================================================
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
26 .SH DESCRIPTION
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
27 Exit successfully if
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
28 .I file
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
29 can be accessed with the specified mode.
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
30 .I mode
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
31 is one or more letters of
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
32 .IR rwx ,
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
33 where
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
34 .I r
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
35 is for readable,
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
36 .I w
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
37 is for writable, and
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
38 .I x
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
39 is for executable.
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
40 .PP
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
41 The difference between
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
42 .B access
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
43 and
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
44 .B test
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
45 is that the latter looks at the permission bits, while the former
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
46 checks using the
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
47 .BR access (2)
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
48 system call. This makes a difference when file systems have been
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
49 mounted read-only.
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
50 .\"=====================================================================
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
51 .SH OPTIONS
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
52 .B access
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
53 accepts the following additional options:
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
54 .TP
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
55 .B --help
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
56 .rb
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
57 Print help message and exit.
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
58 .TP
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
59 .B --version
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
60 .rb
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
61 Print version information and exit.
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
62 .\"=====================================================================
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
63 .SH "SEE ALSO"
1f0b06020e36 [project @ 1998-04-24 04:24:34 by jwe]
jwe
parents:
diff changeset
64 .BR access (2)