.TH "ttail" 1 "Sun May 21 2017" "Version 0.1" "ttail" \" -*- nroff -*- .ad l .nh .SH NAME ttail \- timed tail for logfiles .SH "SYNOSPIS" .PP ttail [OPTION]\&.\&.\&. [FILE]\&.\&.\&. .SH "DESCRIPTION" .PP Display loglines given a minimum date and/or a maximum date\&. .PP For huge files (or a huge list of files) you should have better performance giving files as argument (thank's to binary search on file list and in files)\&. .PP \fB-d --date-min=DATE\fP .RS 4 Start to output loglines starting from this date .RE .PP \fB-m --date-max=DATE\fP .RS 4 Stop to output loglines starting from this date .RE .PP \fB-f --date-format=FMT\fP .RS 4 The date format present in the logfiles and used by -d --date-min and -m --date-max options (see \fBDate formats\fP for more details) .RE .PP \fB-p --prefix-len\fP .RS 4 Set a constant prefix len to drop for each logline .RE .PP \fB-P --permissive\fP .RS 4 Tell ttail to continue after some errors (prefix or date not found, invalid file, etc\&.) .RE .PP \fB-r --re-prefix=REGEX\fP .RS 4 Drop matching prefix for each logline .RE .PP \fB-E --re-extended \fP .RS 4 Interpret -r --re-prefix as an extended regular expression (specified by POSIX) .RE .PP \fB-I --re-ignore-cas\fP .RS 4 Ignore case for -r --re-prefix option (specified by POSIX) .RE .PP \fB-v[v[v[\&.\&.\&.]]]\fP .RS 4 Augment the loglevel .RE .PP .SH "Date formats" .PP ttail understand two date formats : strprtime and relative .SS "Relative date format" Relative date format is used with -d --date-min or -m --date-max arguments\&. The shape of a relative date is '-#[VAL][UNIT]' with VAL an integer and UNIT one of the recognized units : .IP "\(bu" 2 y[ear] .IP "\(bu" 2 M[onth] .IP "\(bu" 2 d[ay] .IP "\(bu" 2 h[our] .IP "\(bu" 2 m[in] .IP "\(bu" 2 s[ec] .PP .SS "Strptime date format" The supported input field descriptors are listed below\&. In case a text string (such as the name of a day of the week or a month name) is to be matched, the comparison is case insensitive\&. In case a number is to be matched, leading zeros are permitted but not required\&. .PP %% The % character\&. .PP %a or A The name of the day of the week according to the current locale, in abbreviated form or the full name\&. .PP %b or B or h The month name according to the current locale, in abbreviated form or the full name\&. .PP %c The date and time representation for the current locale\&. .PP %C The century number (0-99)\&. .PP %d or e The day of month (1-31)\&. .PP %D Equivalent to m/d/y\&. (This is the American style date, very confusing to non-Ameri‐ cans, especially since d/m/y is widely used in Europe\&. The ISO 8601 standard format is Y-m-d\&.) .PP %H The hour (0-23)\&. .PP %I The hour on a 12-hour clock (1-12)\&. .PP %j The day number in the year (1-366)\&. .PP %m The month number (1-12)\&. .PP %M The minute (0-59)\&. .PP %n Arbitrary whitespace\&. .PP %p The locale's equivalent of AM or PM\&. (Note: there may be none\&.) .PP %r The 12-hour clock time (using the locale's AM or PM)\&. In the POSIX locale equivalent to %I:M:S p\&. If t_fmt_ampm is empty in the LC_TIME part of the current locale, then the behavior is undefined\&. .PP %R Equivalent to H:M\&. .PP %S The second (0-60; 60 may occur for leap seconds; earlier also 61 was allowed)\&. .PP %t Arbitrary whitespace\&. .PP %T Equivalent to H:M:S\&. .PP %U The week number with Sunday the first day of the week (0-53)\&. The first Sunday of Janu‐ ary is the first day of week 1\&. .PP %w The ordinal number of the day of the week (0-6), with Sunday = 0\&. .PP %W The week number with Monday the first day of the week (0-53)\&. The first Monday of Janu‐ ary is the first day of week 1\&. .PP %x The date, using the locale's date format\&. .PP %X The time, using the locale's time format\&. .PP %y The year within century (0-99)\&. When a century is not otherwise specified, values in the range 69-99 refer to years in the twentieth century (1969-1999); values in the range 00-68 refer to years in the twenty-first century (2000-2068)\&. .PP %Y The year, including century (for example, 1991)\&. .PP Some field descriptors can be modified by the E or O modifier characters to indicate that an alternative format or specification should be used\&. If the alternative format or specification does not exist in the current locale, the unmodified field descriptor is used\&. .PP The E modifier specifies that the input string may contain alternative locale-dependent versions of the date and time representation: .PP %Ec The locale's alternative date and time representation\&. .PP %EC The name of the base year (period) in the locale's alternative representation\&. .PP %Ex The locale's alternative date representation\&. .PP %EX The locale's alternative time representation\&. .PP %Ey The offset from EC (year only) in the locale's alternative representation\&. .PP %EY The full alternative year representation\&. .PP The O modifier specifies that the numerical input may be in an alternative locale-dependent for‐ mat: .PP %Od or Oe The day of the month using the locale's alternative numeric symbols; leading zeros are permitted but not required\&. .PP %OH The hour (24-hour clock) using the locale's alternative numeric symbols\&. .PP %OI The hour (12-hour clock) using the locale's alternative numeric symbols\&. .PP %Om The month using the locale's alternative numeric symbols\&. .PP %OM The minutes using the locale's alternative numeric symbols\&. .PP %OS The seconds using the locale's alternative numeric symbols\&. .PP %OU The week number of the year (Sunday as the first day of the week) using the locale's alternative numeric symbols\&. .PP %Ow The ordinal number of the day of the week (Sunday=0), using the locale's alternative numeric symbols\&. .PP %OW The week number of the year (Monday as the first day of the week) using the locale's alternative numeric symbols\&. .PP %Oy The year (offset from C) using the locale's alternative numeric symbols\&. .SH "AUTHOR" .PP Written by Yann Weber .SH "COPYRIGHT" .PP Copyright © 2017 Weber Yann License GPLv3+: GNU GPL version 3 or later \&. .PP This is free software: you are free to change and redistribute it\&. There is NO WARRANTY, to the extent permitted by law\&.