unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



pathchk(1)							   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 indus-
  try 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 path-
  name argument	could be created without violating any of the preceding	cri-
  teria.

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 multi-
      byte characters in arguments).

  LC_MESSAGES
      Determines the locale for	the format and contents	of diagnostic mes-
      sages 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)