1 .TH fag 1 "16 February 2018" "1.2" "User Commands"
4 fag \- daemonize program after a regular expression pattern was matched (ForkAfterGrep)
11 .RI [ ARGUMENTS .\|.\|.]
17 to search the output of
19 for the regular expression
21 and daemonizes it when a match is found. The PID is then returned on stdout.
23 .SS "Behaviour Changing Options"
25 .BI \-t " SECONDS" "\fR
30 .BR \-k " [" \fISIGNAL\fP "]
31 If given, send a signal to
36 Right now, only decimal notation is implemented.
52 The file will be opened in append mode and created with permissions 0600 if it doesn't exist.
62 Be verbose; print program's
67 .SS "Generic Program Information"
70 Output a short usage message and exit.
73 Display version and copyright information and exit.
74 .SS "Supported grep Options"
76 .BR \-E ", " \-F ", " \-G ", " \-P
77 Matcher selection switches for extended regular expressions, fixed strings, basic regular expressions (default) or Perl-compatible regular expressions. You may only supply one of them.
79 .BR \-i ", " \-w ", " \-x ", " \-U
80 Matching control switches for ignore case distinctions, whole words only, whole lines only and treat as binary.
83 Decompression switches for
87 Not widely supported; check your \fBgrep\fR's capabilities.
91 was found, 0 is returned. Otherwise, the exit status follows the BSD guideline outlined in
92 .B #include <sysexits.h>
93 if the error occured from within
95 or in case the chid process exits prematurely, its exit code is inherited. Notably, \fI69\fP is returned when the timeout is reached.
98 if grep gets killed (e.g. `killall grep'), fag should terminate.
100 Please report bugs and patches to the issue tracker at https://github.com/girst/forkaftergrep/.
103 needs to be given as an integer. implementing mnemonics is dirty and not very portable; maybe support in the future.
107 gets interrupted or terminated,
112 In 1.2 the command line switch
113 .B \-e was renamed to
116 .B grep\fR's own switches.
118 Copyright 2017 Tobias Girstmair. This is free software; see https://www.gnu.org/licenses/gpl-3.0.html for conditions.
120 Tobias Girstmair (https://gir.st)