Quick Navigator

Search Site

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

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  FTIMES-SIZIMUS (1)

.ds Aq ’


ftimes-sizimus - Tally bytes based on the size attribute.



ftimes-sizimus [-v] [-d delimiter] [-i count] [-l field[,field[,...]]] [-M pattern] [-m pattern-file] [-o option[,option[,...]]] [-t template] -f {file|-}


This utility takes FTimes map data and tallies bytes for regular files based on the size attribute. The input format can vary so long as it contains at least the ’name’, ’mode’, and ’size’ fields. The most common input formats are produced by ftimes(1) and tarmap(1). If the input does not contain the ’mode’ field, you will need to specify the ’NoMode’ option to prevent a fatal error. The reason for this is that directories and special files should generally be ignored when sizing map data.


-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 count] Specifies the number of leading input lines to ignore.
-l field,[field[,...]] Specifies the list of valid input fields. This option is only needed in cases where the input contains unknown fields.
-o option,[option[,...]] Specifies the list of options to apply. Currently the following options are supported:
BeQuiet Don’t print warning messages.
DeriveHeader Construct an artificial header from the list of input fields specified in the -l command line argument. 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).
NoHeader Don’t print an output header.
NoMode Allow processing to continue even if the input has no ’mode’ field.
-M pattern Specifies a pattern that is to be applied to the input records. Any records not matched by the pattern will be discarded. Use the -v option to invert the sense of the match.
-m pattern-file Specifies a file containing zero or more patterns, one per line, that are to be applied to the input records. Any records not matched by the pattern will be discarded. Use the -v option to invert the sense of the match.
-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 may be used to create a custom template: %bytes, %KB, %MB, %GB, %TB, and %files.

-v Invert the sense of pattern matching — similar to the way that egrep(1) works.


Klayton Monroe


ftimes(1) and tarmap(1)


This utility was initially written to assist in sizing calculations in a case where we needed to pull a lot of files from a number of servers in a production environment.

This utility first appeared in FTimes 3.9.0.


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-SIZIMUS (1) 2016-04-05

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