coreutils: pathchk invocation

1 
1 18.3 ‘pathchk’: Check file name validity and portability
1 ========================================================
1 
1 ‘pathchk’ checks validity and portability of file names.  Synopsis:
1 
1      pathchk [OPTION]... NAME...
1 
1    For each NAME, ‘pathchk’ prints an error message if any of these
1 conditions is true:
1 
1   1. One of the existing directories in NAME does not have search
1      (execute) permission,
1   2. The length of NAME is larger than the maximum supported by the
1      operating system.
1   3. The length of one component of NAME is longer than its file
1      system’s maximum.
1 
1    A nonexistent NAME is not an error, so long a file with that name
1 could be created under the above conditions.
1 
11    The program accepts the following options.  Also see ⇒Common
 options.  Options must precede operands.
1 
1 ‘-p’
1      Instead of performing checks based on the underlying file system,
1      print an error message if any of these conditions is true:
1 
1        1. A file name is empty.
1 
1        2. A file name contains a character outside the POSIX portable
1           file name character set, namely, the ASCII letters and digits,
1           ‘.’, ‘_’, ‘-’, and ‘/’.
1 
1        3. The length of a file name or one of its components exceeds the
1           POSIX minimum limits for portability.
1 
1 ‘-P’
1      Print an error message if a file name is empty, or if it contains a
1      component that begins with ‘-’.
1 
1 ‘--portability’
1      Print an error message if a file name is not portable to all POSIX
1      hosts.  This option is equivalent to ‘-p -P’.
1 
1    Exit status:
1 
1      0 if all specified file names passed all checks,
1      1 otherwise.
1