fsfiles - Create a file of all the filenames in a file system


  fsfiles [options] <filesys1> ... <filesysN>


fsfiles creates a file list of all the filenames in a named file system. (It handles plain file hierarchies as well; the name came because it was originally written for use with file systems.) The file list may be sorted or unsorted, depending on the options given.

If no file systems are given on the command line, then the root file system will be used. If any file systems were given, then their files will be included in the file list.

By default, fsfiles does not cross file system boundaries. This may be changed by using the -noxdev option.

The files in the hierarchies on the hierarchy list will be written to an output file. The default file-list file is ./fsfiles. A different file may be specified with the -outfile option. If the output file exists, it must be a regular file and be writable. If it doesn't exist, fsfiles must be able to create the file.

The file list is built using the find command. Specific behaviors, such as whether or not symbolic links are followed, depends on how find behaves. The find execution can be fine-tuned by using the -findopts option with fsfiles.

The file list is sorted using the sort command. Specific behaviors, such as sort ordering, depends on how sort behaves.

fsfiles is essentially a front-end to find and sort. Complex invocations of either command might be better suited by using those commands directly.


fsfiles takes the following options:


Copyright 2015 Wayne Morrison

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Wayne Morrison,


find(1), sort(1)