Index for Section 1

Alphabetical listing for P

Bottom of page

pathchk(1)
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
  -p  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
  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:

  0   All path name operands passed the checks.

  >0  An error occurred.

SEE ALSO
  Commands:  test(1)

  Files:  limits(4)

  Standards:  standards(5)

Index for Section 1

Alphabetical listing for P

Top of page