git.sur5r.net Git - bacula/bacula/blob - bacula/manpages/bregex.8

   1 .\"                                      Hey, EMACS: -*- nroff -*-
   2 .\" First parameter, NAME, should be all caps
   3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
   4 .\" other parameters are allowed: see man(7), man(1)
   5 .TH BREGEX 8 "30 October 2011" "Kern Sibbald" "Network backup, utilities"
   6 .\" Please adjust this date whenever revising the manpage.
   7 .\"
   8 .\" Some roff macros, for reference:
   9 .\" .nh        disable hyphenation
  10 .\" .hy        enable hyphenation
  11 .\" .ad l      left justify
  12 .\" .ad b      justify to both left and right margins
  13 .\" .nf        disable filling
  14 .\" .fi        enable filling
  15 .\" .br        insert line break
  16 .\" .sp <n>    insert n+1 empty lines
  17 .\" for manpage-specific macros, see man(7)
  18 .SH NAME
  19  bregex \- Bacula's 'regex' engine
  20 .SH SYNOPSIS
  21 .B bregex
  22 .RI [ options ]
  23 .I -f <data\-file>
  24 .br
  25 .SH DESCRIPTION
  26 This manual page documents briefly the
  27 .B bregex
  28 command.
  29 .br
  30 This program can be useful for testing regex expressions to be applied against a list of filenames.
  31 .PP
  32 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
  33 .\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
  34 .\" respectively.
  35 .SH OPTIONS
  36 A summary of options is included below.
  37 .TP
  38 .B \-?
  39 Show version and usage of program.
  40 .TP
  41 .BI \-d\  nn
  42 Set debug level to \fInn\fP.
  43 .TP
  44 .BI \-dt
  45 Print timestamp in debug output
  46 .TP
  47 .BI \-f\ <data\-file>
  48 The data-file is a filename that contains lines of data to be matched (or not) against one or more patterns. When the program is run, it will prompt you for a regular expression pattern, then apply it one line at a time against the data in the file. Each line that matches will be printed preceded by its line number. You will then be prompted again for another pattern.
  49 .TP
  50 .BI \-n
  51 Print lines that do not match
  52 .TP
  53 .BI \-l
  54 Suppress lines numbers.
  55 .SH SEE ALSO
  56 .BR regex(7)
  57 .br
  58 .SH AUTHOR
  59 This manual page was written by Bruno Friedmann
  60 .nh
  61 <bruno@ioda\-net.ch>.
  62 This man page document is released under the BSD 2-Clause license.