Content-type: text/html Man page of pathchk

pathchk

Section: User Commands (1)
Index Return to Main Contents
 

NAME

pathchk - Checks path names  

SYNOPSIS

pathchk [-p] pathname...


 

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

pathchk:  XPG4, XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.
 

OPTIONS

Performs 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

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

To check the validity and portability of the /u/bob/work/tempfiles path name, enter: pathchk /u/bob/work/tempfiles 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: 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. If set to a non-empty string value, overrides the values of all the other internationalization variables. 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). Determines the locale for the format and contents of diagnostic messages written to standard error. Determines the location of message catalogues for the processing of LC_MESSAGES.
 

FILES

System maximum values
 

EXIT STATUS

The pathchk command returns the following exit values: All path name operands passed the checks. An error occurred.
 

SEE ALSO

Commands:  test(1)

Files:  limits(4)

Standards:  standards(5)


 

Index

NAME
SYNOPSIS
STANDARDS
OPTIONS
OPERANDS
DESCRIPTION
EXAMPLES
ENVIRONMENT VARIABLES
FILES
EXIT STATUS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:43:00 GMT, October 02, 2010