pathchk(1) — Commands
NAME
pathchk − Checks path names
SYNOPSIS
pathchk [−p] pathname...
STANDARDS
Interfaces documented on this reference page conform to industry standards as follows:
pathchk: XCU5.0
Refer to the standards(5) reference page for more information about industry standards and associated tags.
OPTIONS
−pPerforms path name checks based on POSIX portability standards. An error message is sent if any of the following conditions are true:
•The byte length of the full path name is longer than allowed by POSIX standards ({_POSIX_PATH_MAX}).
•The byte length of a component is longer than allowed by POSIX standards ({_POSIX_NAME_MAX}).
•A character in any component is not in the portable file name character set.
OPERANDS
pathname
The path name to be checked.
DESCRIPTION
The pathchk command checks that one or more path names are valid (that is, they can be used to access or create a file without causing syntax errors) and portable (that is, no file name truncation will result).
By default, the pathchk command checks each component of each path name specified by the pathname argument based on the underlying file system. If the −p option is not specified, pathchk sends an error message if any of the following conditions are true:
•The byte length of the full path name is longer than allowed by the system ({PATH_MAX} bytes).
•The byte length of a component is longer than allowed by the system ({NAME_MAX} bytes).
•Search permission is not allowed for a component.
•A character in any component is not valid in its containing directory.
It is not considered an error if one or more components of a path name do not exist, as long as a file matching the path name specified by the pathname argument could be created without violating any of the preceding criteria.
EXAMPLES
1.To check the validity and portability of the /u/bob/work/tempfiles path name, enter:
pathchk /u/bob/work/tempfiles
2.To check the validity and portability of the /u/bob/temp path name for POSIX standards, enter:
pathchk -p /u/bob/temp
ENVIRONMENT VARIABLES
The following environment variables affect the execution of pathchk:
LANG
Provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the default locale is used. If any of the internationalization variables contain an invalid setting, the utility behaves as if none of the variables had been defined.
LC_ALL
If set to a non-empty string value, overrides the values of all the other internationalization variables.
LC_CTYPE
Determines the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as opposed to multibyte characters in arguments).
LC_MESSAGES
Determines the locale for the format and contents of diagnostic messages written to standard error.
NLSPATH
Determines the location of message catalogues for the processing of LC_MESSAGES.
FILES
/usr/include/limits.h
System maximum values
EXIT STATUS
The pathchk command returns the following exit values:
0All path name operands passed the checks.
>0An error occurred.