Return to en300468ts.1.src CVS log

Up to [DVB] / multiplexer

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

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