aboutsummaryrefslogtreecommitdiff
path: root/doc/binlogsel.1
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2013-10-16 17:07:13 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2013-10-16 17:07:13 +0300
commit099f972e4537a84e9b19abdfc43baf78081e4e09 (patch)
treecae3aba99e422fd81b9de9cfabc2809f3ecfe1c2 /doc/binlogsel.1
parent340802898d02bad367efc8f8ba1517d42fe4baad (diff)
downloadvmod-binlog-099f972e4537a84e9b19abdfc43baf78081e4e09.tar.gz
vmod-binlog-099f972e4537a84e9b19abdfc43baf78081e4e09.tar.bz2
Add manpages.
Diffstat (limited to 'doc/binlogsel.1')
-rw-r--r--doc/binlogsel.1143
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:
+
+

Return to:

Send suggestions and report system problems to the System administrator.