SNFSNAMESCANNER

Section: Maintenance Commands (8)
Updated: August 2018


NAME

SNFSNAMESCANNER – Scan for unusual names in a StorNext File System

SYNOPSIS

/usr/cvfs/lib/snfsnamescanner -ipu|-h pathname

DESCRIPTION

snfsnamescanner scans the StorNext file system startingat the specified pathname for file and directory names that are:

Illegal Windows names. Names that do not conform to the Windows naming convention.
Names with Unicode Private User Area (PUA) code points. Illegal Windows names that are created by Mac and Linux SMB clients.
Names with invalid UTF-8 values. Names created by StorNext Linux and Mac clients using invalid UTF-8 hex sequences.

If snfsnamescanner finds a name with one of the specified problems, it creates a script which can be used to change the name of the file.

pathname is the path to the root directory of a mount StorNext file system.

Snfsnamescanner can only be run on a Linux system. You may need to become user root to access all the files and directories in the file system. Run snfsnamescanner on the active MDC for the fastest scan times.

OPTIONS

-i
Scan the specified file system for illegal Windows file names. The file names with illegal file names are placed in the file illegalFileNames.sh. This file can be used for changing the file name to a legal Windows file name.
-p
Scan the specified file system for file names with PUA code points in the name. The file names with PUA code points are put in the file puaFileNames.sh. This file can be used for changing the file name to an equivalent name with ASCII characters.
-u
Scan the specified file system for file names with invalid UTF-8 values in the name. The file names with invalid UTF-8 are put in the file utf8FileNames.sh.
-h
Display help

You can specify one or more of the -i, -p or -u options at the same time. Specifying more than one option is more efficient than running snfsnamescanner multiple times.

Examples:

To scan for illegal Windows file names:

snfsnamescanner -i /stornext/snfs1

The list of illegal file names is written to ./illegalFileNames.sh. Each line in illlegalFileNames.sh will have identical source and target file file names. You will have to decide on how to change the target file name to a legal Windows file name.

To scan for PUA code points in file system names:

snfsnamescanner -p /stornext/snfs1

The list of file names with PUA code points is written to ./puaFileNames.sh. This script can be used without modification. Run this script on the same system it was created since it uses the mount point to the file system. This script will replace each PUA code point in a file or directory name with the equivalent PUA code point ASCII character.

FILES

/usr/cvfs/lib/snfsnamescanner
./illegalFileNames.sh
./puaFileNames.sh
./utf8FileNames.sh

SEE ALSO

For more information about illegal Windows file name and Unicode Private User Area code points, see the “StorNext File Name Considerations” section in the StorNext User’s Guide.