FTIMES-XFORMER(1) FTimes Documentation FTIMES-XFORMER(1) NAME ftimes-xformer - Tranform FTimes data based on user-specified input SYNOPSIS ftimes-xformer [{-A|-a|-B|-b|-S|-s} eval-block] [{-D|-d} delimiter] [-I pattern] [-i count] [{-L|-l} field[,field[,...]]] [-o option[,op- tion[,...]]] [-p count] [-t template] -f {file|-} DESCRIPTION This utility takes FTimes data and transforms it according to user-speci- fied criteria. OPTIONS -A eval-block Specifies a post-header eval-block to be executed by Perl after the output header has been formed. The eval-block operates on a single line, which is stored in '$_'. -a eval-block Specifies a post-record eval-block to be executed by Perl after the output record has been formed. The eval-block operates on a single line, which is stored in '$_'. -B eval-block Specifies a pre-header eval-block to be executed by Perl before the output header has been split into individual fields. The eval-block operates on a single line, which is stored in '$_'. -b eval-block Specifies a pre-record eval-block to be executed by Perl before the output record has been split into individual fields. The eval-block operates on a single line, which is stored in '$_'. -D delimiter Specifies the output field delimiter. Valid delimiters include the following characters: tab ('\t'), space (' '), comma (','), colon (':'), semi-colon (';'), equal ('='), and pipe ('|'). The default de- limiter is a pipe. -d delimiter Specifies the input field delimiter. Valid delimiters include the fol- lowing characters: tab ('\t'), space (' '), comma (','), colon (':'), semi-colon (';'), equal ('='), and pipe ('|'). The default delimiter is a pipe. Note that parse errors are likely to occur if the specified delimiter appears in any of the field values. -f {file|-} Specifies the name of the input file. A value of '-' will cause the program to read from stdin. [-I pattern] Specifies a regular expression pattern that is used to ignore matching input lines. [-i count] Specifies the number of leading input lines to ignore. -L field,[field[,...]] Specifies the list of output fields. The order of the fields in this list determines their order in the output. Fields in the input that are omitted from this list will be omitted from the output. If the template option (-t) is used, it takes precedence over this option. -l field,[field[,...]] Specifies the list of valid input fields. This option is only needed in cases where the input contains fields not known to FTimes. If the input contains fields not known to FTimes or specified in this list, the script will abort. -o option,[option[,...]] Specifies the list of options to apply. Currently, the following op- tions are supported: BeQuiet Don't print warning messages. DecodeMode Convert mode into its human readable form -- similar to the output produced by ls(1). DeNeuter Remove URL encoding from the name field. Note that this may cause issues with how the output is rendered on your terminal. For exam- ple, the actual name field may contain special or non-printable characters. DeriveFields Assume there is no header, and create field names based on the nu- meric position of each field found in the first record. The first field name would be '1', the second '2', and so on. These fields may be accessed and/or operated on in a split-record eval-block us- ing the standard notation (e.g., $R{'1'}). They may also be used in output templates (e.g., %1). Refer to the -s and -t options for additional details. DeriveHeader Construct an artificial header from the list of input fields speci- fied in the -l command line argument and insert it into the input stream. This option is useful in cases where the input file does not contain its own header. The artificial header is constructed by joining the input fields (in the order they were specified) with the input delimiter (see -d option). Once inserted into the input stream, this header is subject to pre- and post-header eval-block operations (see -B and -A options, respectively). NoHeader Don't print an output header. Note that this overrides all other header transformations. NoQuotes Remove the double quotes that FTimes wraps around each name field. ParseName Split the name field into its components and place the results into the following fields: directory, filename, basename, and extension. The following regular expression is used to pick off the extension: [.][^.]*$ -p count Specifies a path strip count. This value can be used to strip away leading path components in the name field. This is useful in cases where you want to compare two snapshots that begin with different pre- fixes. If the strip count is too high, the name field for various records will be obliterated, and that, in turn, will result in no out- put being printed for the affected records. -S eval-block Specifies a split-header eval-block to be executed by Perl once the header fields have been split. The eval-block operates on values stored in the '%H' hash. The members of the hash are the field names obtained from the header line of the input file (e.g., $H{'name'}, $H{'size'}, etc.). Refer to the token lists documented in the -t de- scription for the complete list of FTimes fields. -s eval-block Specifies a split-record eval-block to be executed by Perl once the record fields have been split. The eval-block operates on values stored in the '%R' hash. The members of the hash are the field names obtained from the header line of the input file (e.g., $R{'name'}, $R{'size'}, etc.). Refer to the token lists documented in the -t de- scription for the complete list of FTimes fields. -t template Specifies a template for an alternate output format. All occurrences of '\n', '\r', or '\t' will be converted to newline, carriage return, and tab, respectively. The value '%%' will be converted to '%'. The following tokens, given that they are defined, may be used to cre- ate custom templates: %altstreams, %ams, %atime, %attributes, %basename %category, %changed, %chms, %chtime, %cms, %ctime, %ctx_offset, %ctx_string, %dev, %dig_name, %dig_offset, %dig_string, %directory, %extension, %filename, %findex, %gid, %hostname, %inode, %joiner, %lh_length, %magic, %md5, %mh_length, %mms, %mode, %mtime, %name, %nlink, %offset, %rdev, %records, %rh_length, %sha1, %sha256, %size, %string, %tag, %type, %uid, %unknown, %volume, %z_altstreams, %z_ams, %z_atime, %z_attributes, %z_chms, %z_chtime, %z_cms, %z_ctime, %z_dev, %z_findex, %z_gid, %z_inode, %z_magic, %z_md5, %z_mms, %z_mode, %z_mtime, %z_name, %z_nlink, %z_rdev, %z_sha1, %z_sha256, %z_size, %z_uid, and %z_volume. Note that the %directory, %filename, %basename, and %extension fields are defined only when the name field is in the input stream and the 'ParseName' option is enabled. If the DeriveFields option was specified, the tokens %1, %2, etc. will also be available for use. AUTHOR Klayton Monroe SEE ALSO ftimes(1) LICENSE All documentation and code are distributed under same terms and conditions as FTimes. perl v5.42.3 2026-08-27 FTIMES-XFORMER(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHOR | SEE ALSO | LICENSE
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ftimes-xformer&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>