summaryrefslogtreecommitdiff
path: root/base/docs/man5/BlockReaderCLI.5
blob: 28b9e3fb5783c970578aeadfa6363d1edef5dd28 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
\# Load custom macros
.so custom.tmac
.TH BlockReaderCLI 5 "2017-09-10" "" ""
.SH NAME
BlockReaderCLI \- configure \fBBlockReaders\fP from a script
.SH DESCRIPTION
A small language for configuring \fBBlockReaders\fP from a script. This is a
command based language, where each command comes on its own line for
configuration. Certain commands may start a sub-mode.
.SH COMMANDS
The following is a description of the syntax and usage for each command. The
following meta-syntatic variables are given the following meanings whenever they
are encountered.
.SS VARIABLES
.TP
.B <block-name>
The name to bind the block reader this command creates to
.TP
.B <reader-name>
The name of an existing block reader.
.SS DESCRIPTIONS
.TP
.BI "def\-filtered" " <block-name> <reader-name> <filter>"
Define a block reader that only accepts blocks that pass the specified filter.
.Arguments
.TP
.I <filter>
A regular expression that the blocks must match.
.EArguments
.TP
.BI "def\-layered" " <block-name> <reader-name1> <reader-name2>"
Define a block reader that merges two readers, but prioritizes blocks from one
over the other.
.TP
.BI "def\-pushback" " <block-name> <reader-name>"
Define a block reader that supports ``unreading'' blocks.
.TP
.BI "def\-simple" " <block-name> <source-name> <pattern>"
Define a block reader that reads blocks delimited by a pattern from an input
source.
.Arguments
.TP
.I <source-name>
The name of the input source to read blocks from.
.TP
.I <pattern>
The pattern to use as a delimiter between blocks.
.EArguments
.TP
.BI "def\-serial" " <block-name> <reader-name>..."
Defines a block reader that concatenates two block readers.
.TP
.BI "def\-toggled" " <block-name> <reader-name1> <reader-name2>"
Defines a block reader that swaps reading blocks between two block readers.
.TP
.BI "}, end, exit, quit"
All of these exit the configuration CLI.