pathchk(1)                                                       pathchk(1)




 NAME    [Toc]    [Back]
      pathchk - check path names

 SYNOPSIS    [Toc]    [Back]
      pathchk [-p] pathname...

 DESCRIPTION    [Toc]    [Back]
      The pathchk command checks that one or more path names are valid and
      portable.  By default, the pathchk command checks each component of
      each path name specified by the pathname parameter based on the
      underlying file system.  An error message is written for each path
      name operand that:

           +  is longer than that allowed by the system.

           +  contains any component longer than that allowed by the system.

           +  contains any component in a directory that is not searchable.

           +  contains any character in any component that 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 parameter could be created that does not violate any of
      the checks above.

      More extensive portability checks are performed when the -p flag is
      specified.

    Options    [Toc]    [Back]
      The pathchk command supports the following option:

           -p      Performs path name checks based on POSIX portability
                   standards instead of the underlying file system.  An
                   error message is written for each path name that:

                        +  is longer than _POSIX_PATH_MAX bytes.

                        +  contains any component longer than
                           _POSIX_NAME_MAX bytes.

                        +  contains any character in any component that is
                           not in the portable file name character set.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LC_MESSAGES determines the language in which messages are displayed.

      If LC_MESSAGES is not specified in the environment or is set to the
      empty string, the value of LANG is used as a default for each



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 pathchk(1)                                                       pathchk(1)




      unspecified or empty variable.  If LANG is not specified or is set to
      the empty string, a default of "C" (see lang(5)) is used instead of
      LANG.

      If any internationalization variable contains an invalid setting,
      pathchk behaves as if all internationalization variables are set to
      "C".  See environ(5).

    International Code Set Support    [Toc]    [Back]
      Single-byte and multi-byte character code sets are supported.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, pathchk returns zero; otherwise it returns
      nonzero to indicate an error.

 EXAMPLES    [Toc]    [Back]
      To check the validity and portability of the

           /users/mary/work/tempfiles

      path name on your system, use:

           pathchk /users/mary/work/tempfiles

      To check the validity and portability of the

           /users/mary/temp

      path name for POSIX standards, use:

           pathchk -p /users/mary/temp

 STANDARDS CONFORMANCE    [Toc]    [Back]
      pathchk: XPG4, POSIX.2


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003