Return to en300468ts.1.src CVS log

Up to [DVB] / multiplexer

Annotation of multiplexer/en300468ts.1.src, revision 1.10

1.1       oskar       1: .\" Man page for en300468ts
                      2: .\"
1.4       oskar       3: .\" Copyright (C) GPL 2004..2008, Oskar Schirmer
1.1       oskar       4: .\"
1.4       oskar       5: .TH en300468ts 1 "DATE" "VERSION" "Multiplexer"
1.1       oskar       6: .SH NAME
                      7: en300468ts \- SI table generator (EN 300468) for transport streams
                      8: .SH SYNOPSIS
                      9: en300468ts [CONFIGURATION...]
                     10: .SH DESCRIPTION
                     11: Generates SI tables according to EN 300468 from a set of given tables.
                     12: The result is sent to \fIstdout\fR.
                     13: All arguments are treated as filenames,
                     14: which are supposed to denote configuration files.
                     15: The special filename \fI-\fR stands for \fIstdin\fR.
                     16: Each of these files is read line by line, each line refers
                     17: to one table and must have one of the following two forms:
                     18: .TP
                     19: .BI S\  pid\ tableid\ frequency\ file
                     20: The \fIfile\fR is opened and read, it shall contain the table
                     21: contents in simple ascii.
                     22: This table shall be reproduced every \fIfrequency\fR msecs,
                     23: the tableid is \fItableid\fR, the pid is \fIpid\fR.
1.9       oskar      24: If a table with this \fItableid\fR and \fIpid\fR and,
                     25: if applicable, the same \fItableid_extension\fR,
                     26: existed before,
1.1       oskar      27: it is purged first.
                     28: If \fIfrequency\fR is \fB0\fR,
                     29: the table is output only once and not repeated
                     30: .TP
                     31: .BI -\  pid\ tableid
1.9       oskar      32: All corresponding tables will be deleted from the list
1.1       oskar      33: of tables to generate
                     34: .P
                     35: While the primary configuration files are line oriented,
                     36: the table description files are not. They are composed of
1.4       oskar      37: a sequence of tokens, which directly depends on the type
1.1       oskar      38: of the table. See the sections \fBTOKENS\fR and \fBTABLES\fR
                     39: for details.
                     40: .SH EXAMPLE
                     41: The output of \fIen300468ts\fR shall be piped to
                     42: \fIiso13818ts\fR:
                     43: .IP
                     44: $ mkfifo table_pipe
                     45: .br
                     46: $ en300468ts en.conf > table-pipe &
                     47: .br
                     48: $ iso13818ts -B --ts table-pipe --si = 0x10 0x1F > /dev/xvdb1
                     49: .br
                     50: \&...
                     51: .PP
                     52: The example refers to the configuration file \fBen.conf\fR:
                     53: .IP
                     54: S 0x10 0x40 1000 /tmp/nit
                     55: .br
                     56: S 0x13 0x71 1500 /tmp/rst
                     57: .PP
                     58: This in turn refers to two table description files (the
                     59: examples do not show useful values),
                     60: one is \fBnit\fR:
                     61: .IP
                     62: 4711
                     63: .br
                     64: 1
                     65: .br
                     66:   0x40 "Glotz-NET"
                     67: .br
                     68: 1
                     69: .br
                     70:   0x0815
                     71: .br
                     72:   4710
                     73: .br
                     74:   0
                     75: .PP
                     76: The other table description file is \fBrst\fR:
                     77: .IP
                     78: 2
                     79: .br
                     80:   2342 991 1 42 1
                     81: .br
                     82:   4711 992 3 56 1
                     83: .PP
                     84: The example will produce a \fBnit\fR table once a second
                     85: and an \fBrst\fR table once in one and a half second.
                     86: .SH TOKENS
                     87: The table descriptor files are made up of the following tokens:
                     88: .TP
                     89: .B number
                     90: Whereever numerical values are needed, these are given as numbers,
                     91: decimal or hexadecimal or octal according to the preference of the
                     92: user.
                     93: .TP
                     94: \fB"string"\fR
                     95: Whereever character strings are needed, these are given in
                     96: double quotes, with double quotes escaped by double quotes, so:
                     97: \fI"this "" is my quote"\fR.
                     98: .TP
                     99: .B DESCRIPTORS
                    100: When a list of descriptors is expected, first the number of
                    101: descriptors to follow is to be given (not the number of bytes!).
                    102: Then the descriptors follow one by one, see section \fIDESCRIPTORS\fR
                    103: for details.
                    104: .TP
                    105: .BR LOOP( ... )
                    106: Parts of a table may be repeated. The number of repeatitions
                    107: is given first, then the contents of the loop is given as often
                    108: as it was denoted first.
                    109: .TP
                    110: .B YYYY/MM/DD HH:MM:SS
                    111: When date and time information is needed, this is given
1.5       oskar     112: in exactly the following form: \fIYYYY/MM/DD\~HH:MM:SS\fR,
                    113: 19 characters, the slashes, colons and one blank exactly as given here,
                    114: e.g.: \fI2006/01/31\~20:54:56\fR.
1.1       oskar     115: .SH TABLES
                    116: The syntax of the single table types is given next, with
                    117: valid pid and tableid given in parantheses:
                    118: .TP
1.4       oskar     119: .\" INCLUDE-TABLE
1.1       oskar     120: .BR
                    121: .P
                    122: Note, that the \fBTDT\fR table is empty and thus may
                    123: be represented by the empty file \fB/dev/null\fR.
                    124: .SH DESCRIPTORS
                    125: Descriptors are made up of tokens like tables are, where an
                    126: additional descriptor tag is preceeding.
                    127: .TP
1.4       oskar     128: .\" INCLUDE-DESCR
1.1       oskar     129: .BR
                    130: .P
                    131: .SH NOTES
                    132: Someone said, the option \fI--nit\fR might be useful at \fBiso13818ts\fR,
                    133: when it is about DVB-T.
                    134: .SH "SEE ALSO"
                    135: .BR iso13818ts (1),
                    136: .BR ISO\ 13818-1 ,
1.2       oskar     137: .BR ETSI\ EN\ 300\ 468 ,
                    138: .BR ISO\ 639-2 ,
                    139: .BR ISO\ 3166 .
1.1       oskar     140: .SH AUTHOR
                    141: Oskar Schirmer (schirmer@scara.com).
1.6       oskar     142: .br
1.7       oskar     143: Thanks a lot for specific bug fixes and testing to:
                    144: Michal Benes,
1.8       oskar     145: Jaroslav Pech,
1.10    ! oskar     146: Alexander Sergin,
        !           147: Michael Chernyakhovsky.