pathchk1
Check pathnames
Usage
pathchk [-pP]
pathname ...
Overview
The pathchk utility checks whether each of the specified pathname arguments is valid or portable.
A diagnostic message is written for each argument that:
-
Is longer than PATH_MAX bytes.
-
Contains any component longer than NAME_MAX bytes. (The value of NAME_MAX depends on the underlying file system.)
-
Contains a directory component that is not searchable.
It is not considered an error if a pathname argument contains a nonexistent component as long as a component by that name could be created.
The options are as follows:
-
-p -
Perform portability checks on the specified pathname arguments. Diagnostic messages will be written for each argument that:
-
Is longer than _POSIX_PATH_MAX (255) bytes.
-
Contains a component longer than _POSIX_NAME_MAX (14) bytes.
-
Contains any character not in the portable filename character set (that is, alphanumeric characters, ‘.’, ‘-’ and ‘_’). No component may start with the hyphen (‘-’) character.
-
-
-P -
In addition to the default or
-pchecks, write a diagnostic for each argument that:-
Is empty.
-
Contains a component that starts with a hyphen.
-
Exit status
The pathchk utility exits 0 on success, and >0 if an error occurs.
Examples
Check whether the names of files in the current directory are portable to other POSIX systems:
find . -exec pathchk -p -- {} +
Releases
60 releases since FreeBSD 4.8-RELEASE; the text changed 34 times.
- 4.8–4.11
- 5.0–5.5
- 6.0–6.3
- 6.4
- 7.0
- 7.1
- 7.2
- 7.3
- 7.4
- 8.0
- 8.1
- 8.2
- 8.3
- 8.4
- 9.0
- 9.1
- 9.2
- 9.3
- 10.0
- 10.1
- 10.2
- 10.3
- 10.4
- 11.0
- 11.1
- 11.2
- 11.3
- 11.4
- 12.0
- 12.1
- 12.2
- 12.3
- 12.4
- 13.0–13.2
- 13.3–16.0
-P since FreeBSD 8.1-RELEASE.