GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FTIMES-XFORMER (1)

.ds Aq ’

NAME

ftimes-xformer - Tranform FTimes data based on user-specified input

CONTENTS

SYNOPSIS

ftimes-xformer [{-A|-a|-B|-b|-S|-s} eval-block] [{-D|-d} delimiter] [-I pattern] [-i count] [{-L|-l} field[,field[,...]]] [-o option[,option[,...]]] [-p count] [-t template] -f {file|-}

DESCRIPTION

This utility takes FTimes data and transforms it according to user-specified 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 delimiter is a pipe.
-d delimiter Specifies the input field delimiter. Valid delimiters include the following 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 options 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 example, the actual name field may contain special or non-printable characters.
DeriveFields Assume there is no header, and create field names based on the numeric 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 using 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 specified 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 prefixes. If the strip count is too high, the name field for various records will be obliterated, and that, in turn, will result in no output 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 description 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 description 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 create 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.
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 FTIMES-XFORMER (1) 2016-04-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.