diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2013-10-16 17:07:13 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2013-10-16 17:07:13 +0300 |
commit | 099f972e4537a84e9b19abdfc43baf78081e4e09 (patch) | |
tree | cae3aba99e422fd81b9de9cfabc2809f3ecfe1c2 /doc/binlogsel.1 | |
parent | 340802898d02bad367efc8f8ba1517d42fe4baad (diff) | |
download | vmod-binlog-099f972e4537a84e9b19abdfc43baf78081e4e09.tar.gz vmod-binlog-099f972e4537a84e9b19abdfc43baf78081e4e09.tar.bz2 |
Add manpages.
Diffstat (limited to 'doc/binlogsel.1')
-rw-r--r-- | doc/binlogsel.1 | 143 |
1 files changed, 143 insertions, 0 deletions
diff --git a/doc/binlogsel.1 b/doc/binlogsel.1 new file mode 100644 index 0000000..cebb98c --- /dev/null +++ b/doc/binlogsel.1 @@ -0,0 +1,143 @@ +.\" This file is part of Vmod-binlog -*- nroff -*- +.\" Copyright (C) 2013 Sergey Poznyakoff +.\" +.\" Vmod-binlog is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 3, or (at your option) +.\" any later version. +.\" +.\" Vmod-binlog is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with vmod-binlog. If not, see <http://www.gnu.org/licenses/>. +.TH BINLOGSEL 1 "October 16, 2013" "BINLOGSEL" "User Reference" +.SH NAME +binlogsel \- select records from binary logs +.SH SYNOPSIS +\fBbinlogsel\fR [\fB\-dnv\fR] [\fB\-t\fR \fIFORMAT\fR] [\fB\-F\fR +\fITIME\fR] [\fB\-T\fR \fITIME\fR] [\fB\-p\fR \fIPATTERN\fR]\ + [\fB\-D\fR \fIDIR\fR] + [\fIFILE\fR...] + +\fBbinlogsel\fR [\fB\-hV\fR] +.SH DESCRIPTION +.B Binlosel +selects from the binary logs the records that fall within the given +time interval. The interval is specified using the +.BI \-F " FROMTIME" +and +.BI \-T " TOTIME" +options. If both options are used, only records falling within the +interval \fIFROMTIME\fR..\fITOTIME\fR will be returned. If +.B \-F +is used, but +.B \-T +is omitted, \fITOTIME\fR is set to the current time. If +.B \-T +is used, but +.B \-F +is omitted, the starting time is set to the time of the earliest +available log file. Finally, if neither of options is used, all +records will be output. In this case, the operation is equivalent +to that of the +.B binlogcat +command. +.PP +The argument to either option is a mostly free format human readable +date string such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 +16:21:42" or even "2 days ago". It may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. For a detailed description of date input formats, see +section +.B Date input formats +in +.BR "GNU Coreutils manual" . +If the +.B info +program and coreutils documentation are properly installed at your site, use +the following command: +.PP +.EX +.B info coreutils 'Date input formats' +.EE +.PP +The log files are searched in the directory specified with the +\fB\-D\fR command line option. The \fB\-i\fR option can be used to +define directory indexing level. +.PP +If files are listed in the command line, the +.BR \-D , +.BR \-i , +and +.B \-p +options are ignored. +.SH OPTIONS +.TP +.BI \-D " DIR" +Set base log directory. +.TP +.BI \-i " N" +Set directory indexing level. Valid values for \fIN\fR are \fB0\fR, +\fB1\fR and \fB2\fR. +.TP +.BI \-F " TIME" +Select records newer than \fITIME\fR. See the section +\fBDESCRIPTION\fR for a discussion of valid time formats. +.TP +.BI \-T " TIME" +Select records older than \fITIME\fR. +.TP +.BI \-p " PATTERN" +Set pattern for log file names. \fIPATTERN\fR must be a valid +.BR strftime (3) +format string. +.B \-d +Print timestamps relative to first record in the file. +.TP +.B \-n +Precede each record by its number in the file (0-based). +.TP +.B \-v +Print information about each file before dumpng it. +.TP +.BI \-t " FORMAT" +Format timestamps according to \fIFORMAT\fR (see +.BR strftime (3)). +Default is \fB%c\fR. +.TP +.BR \-h +Print a short help summary. +.TP +.BR \-V +Show program version and exit. +.SH "SEE ALSO" +.BR vmod-binlog (3), +.BR binlogcat (1), +.BR vcl (7), +.BR varnishd (1). +.SH AUTHORS +Sergey Poznyakoff +.SH "BUG REPORTS" +Report bugs to <gray@gnu.org>. +.SH COPYRIGHT +Copyright \(co 2013 Sergey Poznyakoff +.br +.na +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +.ad +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.\" Local variables: +.\" eval: (add-hook 'write-file-hooks 'time-stamp) +.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.-]* [0-9] \"" +.\" time-stamp-format: "%:B %:d, %:y" +.\" time-stamp-end: "\"" +.\" time-stamp-line-limit: 20 +.\" end: + + |