crolsma / aproname

Detect problematic pathnames

aproname

Summary

Detect invalid and problematic pathname lengths and patterns, accounting for both unix-like and Microsoft OSes.

Restrictions include:

1. POSIX Portable Filename Character Set,

2. ustar pathname length restrictions,

3. MS-DOS and Microsoft Windows restrictions,

4. additional restrictions to avoid common usability problems.

Invalid pathnames are printed to STDOUT with a summary of problems for each name.

Usage

Check pathnames given as arguments:

aproname pathname…​

Check the pathnames in a directory tree:

find path…​ -exec aproname {} +

Check pathnames from STDIN:

…​ | xargs -I {} aproname {}

…​ | xargs -0 aproname

Exit Status

The script returns exit code 1 if any problematic patterns are found. Otherwise it returns exit code 0.

References

• Portable Filename

• Portable Filename Character Set

• Pathname

• Pathname Resolution

• ustar format

• ustar portability

• Microsoft Windows filenames

• Microsoft OneDrive filenames

• Commentary on safe filenames