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