mirror of
https://github.com/vdr-projects/vdr.git
synced 2025-03-01 10:50:46 +00:00
Try converting with pandoc
parent
85e77de45b
commit
502881baf8
@ -1,294 +1,398 @@
|
|||||||
<table>
|
|
||||||
<tr>
|
<header>
|
||||||
<td>vdr(1)</td>
|
<h1>vdr</h1>
|
||||||
<td>Video Disk Recorder</td>
|
<p>27 Dec 2021</p>
|
||||||
<td>vdr(1)</td>
|
</header>
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<div>
|
|
||||||
<section>
|
|
||||||
<h1>NAME</h1>
|
<h1>NAME</h1>
|
||||||
<p>vdr - the Video Disk Recorder</p>
|
<p>vdr - the Video Disk Recorder</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>SYNOPSIS</h1>
|
<h1>SYNOPSIS</h1>
|
||||||
<p><b>vdr</b> [options]</p>
|
<p><strong>vdr</strong> [options]</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>DESCRIPTION</h1>
|
<h1>DESCRIPTION</h1>
|
||||||
<p><b>vdr</b> implements a complete digital Set-Top Box and Video
|
<p><strong>vdr</strong> implements a complete digital Set-Top Box and
|
||||||
Recorder. It can work with signals received from satellites (DVB-S) as well
|
Video Recorder. It can work with signals received from satellites
|
||||||
as cable (DVB-C) and terrestrial (DVB-T) signals.</p>
|
(DVB-S) as well as cable (DVB-C) and terrestrial (DVB-T) signals.</p>
|
||||||
<p>At least one DVB card is required to run <b>vdr</b>. With it you
|
<p>At least one DVB card is required to run <strong>vdr</strong>. With
|
||||||
can watch live TV while recording one or more other broadcasts from the same
|
it you can watch live TV while recording one or more other broadcasts
|
||||||
transponder. It is also possible to start watching a recorded programme
|
from the same transponder. It is also possible to start watching a
|
||||||
before the live broadcast has ended (<b>time shifting</b>). In order to
|
recorded programme before the live broadcast has ended (<strong>time
|
||||||
record from different transponders simultaneously two or more DVB cards are
|
shifting</strong>). In order to record from different transponders
|
||||||
necessary. By default <b>vdr</b> can support up to eight DVB cards. The
|
simultaneously two or more DVB cards are necessary. By default
|
||||||
primary DVB card (the one your TV set is connected to) can either be a
|
<strong>vdr</strong> can support up to eight DVB cards. The primary DVB
|
||||||
"full featured" card, which means it contains an MPEG decoder and
|
card (the one your TV set is connected to) can either be a "full
|
||||||
provides audio and video signal outputs, or you can use some third party
|
featured" card, which means it contains an MPEG decoder and provides
|
||||||
plugin that implements software decoding of the MPEG data and displays it
|
audio and video signal outputs, or you can use some third party plugin
|
||||||
via the system's graphics adapter.</p>
|
that implements software decoding of the MPEG data and displays it via
|
||||||
<p><b>vdr</b> uses an On Screen Display (OSD) to display its menus.
|
the system's graphics adapter.</p>
|
||||||
It can be controlled by the PC keyboard, the "Linux Infrared Remote
|
<p><strong>vdr</strong> uses an On Screen Display (OSD) to display its
|
||||||
Control" (LIRC), or any other means of remote control, implemented by a
|
menus. It can be controlled by the PC keyboard, the "Linux Infrared
|
||||||
third party plugin.</p>
|
Remote Control" (LIRC), or any other means of remote control,
|
||||||
<p>Remote access is possible via the "Simple Video Disk Recorder
|
implemented by a third party plugin.</p>
|
||||||
Protocol" (SVDRP), which can be accessed on port 6419, for instance by
|
<p>Remote access is possible via the "Simple Video Disk Recorder
|
||||||
<b>telnet</b>.</p>
|
Protocol" (SVDRP), which can be accessed on port 6419, for instance by
|
||||||
</section>
|
<strong>telnet</strong>.</p>
|
||||||
<section>
|
|
||||||
<h1>OPTIONS</h1>
|
<h1>OPTIONS</h1>
|
||||||
<dl>
|
<dl>
|
||||||
<dt><h3><b>-a </b><i>cmd</i><b>, --audio=</b><i>cmd</i></h3></dt>
|
<dt><strong>-a </strong><em>cmd</em><strong>,
|
||||||
<dd>Send Dolby Digital audio to stdin of command <i>cmd</i>.</dd>
|
--audio=</strong><em>cmd</em></dt>
|
||||||
<dt><h3><b>--cachedir=</b><i>dir</i></h3></dt>
|
<dd>
|
||||||
<dd>Save cache files in <i>dir</i> (default is to save them in the video
|
<p>Send Dolby Digital audio to stdin of command <em>cmd</em>.</p>
|
||||||
directory).</dd>
|
</dd>
|
||||||
<dt><h3><b>--chartab=</b><i>character_table</i></h3></dt>
|
<dt><strong>--cachedir=</strong><em>dir</em></dt>
|
||||||
<dd>Set the character table to use for strings in the DVB data stream that
|
<dd>
|
||||||
don't begin with a character table indicator, but don't use the standard
|
<p>Save cache files in <em>dir</em> (default is to save them in the
|
||||||
default character table (for instance ISO-8859-9).</dd>
|
video directory).</p>
|
||||||
<dt><h3><b>-c </b><i>dir</i><b>, --config=</b><i>dir</i></h3></dt>
|
</dd>
|
||||||
<dd>Read config files from directory <i>dir</i> (default is to read them from
|
<dt><strong>--chartab=</strong><em>character_table</em></dt>
|
||||||
the video directory).</dd>
|
<dd>
|
||||||
<dt><h3><b>-d, --daemon</b></h3></dt>
|
<p>Set the character table to use for strings in the DVB data stream
|
||||||
<dd>Run in daemon mode (implies --no-kbd).</dd>
|
that don't begin with a character table indicator, but don't use the
|
||||||
<dt><h3><b>-D </b><i>num</i><b>, --device=</b><i>num</i></h3></dt>
|
standard default character table (for instance ISO-8859-9).</p>
|
||||||
<dd>Use only the given DVB device (<i>num</i> = 0, 1, 2...). There may be
|
</dd>
|
||||||
several <b>-D</b> options (by default all DVB devices will be used). If
|
<dt><strong>-c </strong><em>dir</em><strong>,
|
||||||
<b>-D-</b> is given, no DVB devices will be used at all, independent of
|
--config=</strong><em>dir</em></dt>
|
||||||
any other -D options.</dd>
|
<dd>
|
||||||
<dt><h3><b>--dirnames=</b><i>path</i><b>[,</b><i>name</i><b>[,</b><i>enc</i><b>]]</b></h3></dt>
|
<p>Read config files from directory <em>dir</em> (default is to read
|
||||||
<dd>Set the maximum directory path length to <i>path</i> (default is the
|
them from the video directory).</p>
|
||||||
maximum value allowed on the system). If <i>name</i> is also given, it
|
</dd>
|
||||||
defines the maximum directory name length (default is the maximum value
|
<dt><strong>-d, --daemon</strong></dt>
|
||||||
allowed on the system). The optional <i>enc</i> can be 0 or 1, and
|
<dd>
|
||||||
controls whether special characters in directory names are encoded as hex
|
<p>Run in daemon mode (implies --no-kbd).</p>
|
||||||
values (default: 0). If <i>path</i> or <i>name</i> are left empty (as in
|
</dd>
|
||||||
",,1" to only set <i>enc</i>), the defaults apply. The length of
|
<dt><strong>-D </strong><em>num</em><strong>,
|
||||||
the video directory name and that of the actual recording directory is
|
--device=</strong><em>num</em></dt>
|
||||||
subtracted from <i>path</i>, to make sure the directory path will never
|
<dd>
|
||||||
become too long.</dd>
|
<p>Use only the given DVB device (<em>num</em> = 0, 1, 2...). There may
|
||||||
<dt><h3><b>--edit=</b><i>rec</i></h3></dt>
|
be several <strong>-D</strong> options (by default all DVB devices will
|
||||||
<dd>Edit the given recording. <i>rec</i> must be the full path name of an
|
be used). If <strong>-D-</strong> is given, no DVB devices will be used
|
||||||
existing recording. The program will return immediately after editing the
|
at all, independent of any other -D options.</p>
|
||||||
recording.</dd>
|
</dd>
|
||||||
<dt><h3><b>-E </b><i>file</i><b>, --epgfile=</b><i>file</i></h3></dt>
|
<dt><strong>--dirnames=</strong><em>path</em><strong>[,</strong><em>name</em><strong>[,</strong><em>enc</em><strong>]]</strong></dt>
|
||||||
<dd>Write the EPG data into the given <i>file</i> (default is <i>epg.data</i>
|
<dd>
|
||||||
in the cache directory). Use <b>-E-</b> to disable this. If <i>file</i> is
|
<p>Set the maximum directory path length to <em>path</em> (default is
|
||||||
a directory, the file <i>epg.data</i> will be created in that
|
the maximum value allowed on the system). If <em>name</em> is also
|
||||||
directory.</dd>
|
given, it defines the maximum directory name length (default is the
|
||||||
<dt><h3><b>--filesize=</b><i>size</i></h3></dt>
|
maximum value allowed on the system). The optional <em>enc</em> can be 0
|
||||||
<dd>Limit video files to <i>size</i> bytes (default is 2000M). This option is
|
or 1, and controls whether special characters in directory names are
|
||||||
only useful in conjunction with --edit, and must precede that option to
|
encoded as hex values (default: 0). If <em>path</em> or <em>name</em>
|
||||||
have an effect. <i>size</i> is an integer number and may be followed by
|
are left empty (as in ",,1" to only set <em>enc</em>), the defaults
|
||||||
one of the letters K, M, G or T to abbreviate Kilo-, Mega-, Giga- or
|
apply. The length of the video directory name and that of the actual
|
||||||
Terabyte, respectively. The given value is silently limited to the
|
recording directory is subtracted from <em>path</em>, to make sure the
|
||||||
program's internal minimum and maximum values.</dd>
|
directory path will never become too long.</p>
|
||||||
<dt><h3><b>--genindex=</b><i>rec</i></h3></dt>
|
</dd>
|
||||||
<dd>Generate the index file for the given recording. <i>rec</i> must be the
|
<dt><strong>--edit=</strong><em>rec</em></dt>
|
||||||
full path name of an existing recording. The recording must be in TS
|
<dd>
|
||||||
|
<p>Edit the given recording. <em>rec</em> must be the full path name of
|
||||||
|
an existing recording. The program will return immediately after editing
|
||||||
|
the recording.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-E </strong><em>file</em><strong>,
|
||||||
|
--epgfile=</strong><em>file</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Write the EPG data into the given <em>file</em> (default is
|
||||||
|
<em>epg.data</em> in the cache directory). Use <strong>-E-</strong> to
|
||||||
|
disable this. If <em>file</em> is a directory, the file
|
||||||
|
<em>epg.data</em> will be created in that directory.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--filesize=</strong><em>size</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Limit video files to <em>size</em> bytes (default is 2000M). This
|
||||||
|
option is only useful in conjunction with --edit, and must precede that
|
||||||
|
option to have an effect. <em>size</em> is an integer number and may be
|
||||||
|
followed by one of the letters K, M, G or T to abbreviate Kilo-, Mega-,
|
||||||
|
Giga- or Terabyte, respectively. The given value is silently limited to
|
||||||
|
the program's internal minimum and maximum values.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--genindex=</strong><em>rec</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Generate the index file for the given recording. <em>rec</em> must be
|
||||||
|
the full path name of an existing recording. The recording must be in TS
|
||||||
format. If the recording already has an index file, it will be deleted
|
format. If the recording already has an index file, it will be deleted
|
||||||
before creating the new one. The program will return immediately after
|
before creating the new one. The program will return immediately after
|
||||||
generating the index. Note that using this option while another instance
|
generating the index. Note that using this option while another instance
|
||||||
of VDR is currently replaying the given recording, or if the recording has
|
of VDR is currently replaying the given recording, or if the recording
|
||||||
not been finished yet, may lead to unexpected results.</dd>
|
has not been finished yet, may lead to unexpected results.</p>
|
||||||
<dt><h3><b>-g, --grab=</b><i>dir</i></h3></dt>
|
</dd>
|
||||||
<dd>Write images from the SVDRP command GRAB into the given directory
|
<dt><strong>-g, --grab=</strong><em>dir</em></dt>
|
||||||
<i>dir</i>. <i>dir</i> must be the full path name of an existing
|
<dd>
|
||||||
directory, without any "..", double '/' or symlinks. By default,
|
<p>Write images from the SVDRP command GRAB into the given directory
|
||||||
or if <b>-g-</b> is given, grabbing images to disk is disabled.</dd>
|
<em>dir</em>. <em>dir</em> must be the full path name of an existing
|
||||||
<dt><h3><b>-h, --help</b></h3></dt>
|
directory, without any "..", double '/' or symlinks. By default, or if
|
||||||
<dd>Print a help message and exit.</dd>
|
<strong>-g-</strong> is given, grabbing images to disk is disabled.</p>
|
||||||
<dt><h3><b>-i </b><i>instance</i><b>, --instance=</b><i>instance</i></h3></dt>
|
</dd>
|
||||||
<dd>Use <i>instance</i> as the id of this VDR instance (default is 0). In an
|
<dt><strong>-h, --help</strong></dt>
|
||||||
environment where several instances of VDR use the same video directory,
|
<dd>
|
||||||
this parameter can be set to a positive integer value that's unique for
|
<p>Print a help message and exit.</p>
|
||||||
each instance, so that they won't interfere with each other in case they
|
</dd>
|
||||||
record exactly the same broadcast. The number given here will be part of
|
<dt><strong>-i </strong><em>instance</em><strong>,
|
||||||
the directory name in which the recordings will be stored.</dd>
|
--instance=</strong><em>instance</em></dt>
|
||||||
<dt><h3><b>-l </b><i>level</i><b>, --log=</b><i>level</i></h3></dt>
|
<dd>
|
||||||
<dd>Set logging to <i>level</i>. <b>0</b> = no logging,
|
<p>Use <em>instance</em> as the id of this VDR instance (default is 0).
|
||||||
<b>1</b> = errors only, <b>2</b> = errors and
|
In an environment where several instances of VDR use the same video
|
||||||
info, <b>3</b> = errors, info and debug. The default logging
|
directory, this parameter can be set to a positive integer value that's
|
||||||
level is <b>3</b>. If logging should be done to LOG_LOCAL<i>n</i> instead
|
unique for each instance, so that they won't interfere with each other
|
||||||
of LOG_USER, add '.n' to LEVEL, as in 3.7 (n=0..7).</dd>
|
in case they record exactly the same broadcast. The number given here
|
||||||
<dt><h3><b>-L </b><i>dir</i><b>, --lib=</b><i>dir</i></h3></dt>
|
will be part of the directory name in which the recordings will be
|
||||||
<dd>Search for plugins in directory <i>dir</i> (default is ./PLUGINS/lib).
|
stored.</p>
|
||||||
There can be several <b>-L</b> options with different <i>dir</i> values.
|
</dd>
|
||||||
Each of them will apply to the <b>-P</b> options following it.</dd>
|
<dt><strong>-l </strong><em>level</em><strong>,
|
||||||
<dt><h3><b>--lirc[=</b><i>path</i><b>]</b></h3></dt>
|
--log=</strong><em>level</em></dt>
|
||||||
<dd>Use a LIRC remote control device. If <i>path</i> is omitted, vdr uses
|
<dd>
|
||||||
<i>/var/run/lirc/lircd</i>.</dd>
|
<p>Set logging to <em>level</em>. <strong>0</strong> = no logging,
|
||||||
<dt><h3><b>--localedir=</b><i>dir</i></h3></dt>
|
<strong>1</strong> = errors only, <strong>2</strong> = errors and info,
|
||||||
<dd>Search for locale files in <i>dir</i> (default is ./locale).</dd>
|
<strong>3</strong> = errors, info and debug. The default logging level
|
||||||
<dt><h3><b>-m, --mute</b></h3></dt>
|
is <strong>3</strong>. If logging should be done to LOG_LOCAL<em>n</em>
|
||||||
<dd>Mute audio of the primary DVB device at startup.</dd>
|
instead of LOG_USER, add '.n' to LEVEL, as in 3.7 (n=0..7).</p>
|
||||||
<dt><h3><b>--no-kbd</b></h3></dt>
|
</dd>
|
||||||
<dd>Don't use the keyboard as an input device.</dd>
|
<dt><strong>-L </strong><em>dir</em><strong>,
|
||||||
<dt><h3><b>-p </b><i>port</i><b>, --port=</b><i>port</i></h3></dt>
|
--lib=</strong><em>dir</em></dt>
|
||||||
<dd>Use <i>port</i> for SVDRP. A value of <b>0</b> turns off SVDRP. The
|
<dd>
|
||||||
default SVDRP port is <b>6419</b>. You need to edit the file
|
<p>Search for plugins in directory <em>dir</em> (default is
|
||||||
<i>svdrphosts.conf</i> in order to enable access to the SVDRP port from
|
./PLUGINS/lib). There can be several <strong>-L</strong> options with
|
||||||
hosts other than the localhosts. Note that this option only changes the
|
different <em>dir</em> values. Each of them will apply to the
|
||||||
TCP port used for SVDRP commands. The UDP port for discovering peer VDRs
|
<strong>-P</strong> options following it.</p>
|
||||||
in the same network is always set to 6419 and can't be changed.</dd>
|
</dd>
|
||||||
<dt><h3><b>-P </b><i>options</i><b>, --plugin=</b><i>options</i></h3></dt>
|
<dt><strong>--lirc[=</strong><em>path</em><strong>]</strong></dt>
|
||||||
<dd>Load a plugin, defined by the given <i>options</i>. The first word in
|
<dd>
|
||||||
<i>options</i> must be the name of an existing <b>vdr</b> plugin,
|
<p>Use a LIRC remote control device. If <em>path</em> is omitted, vdr
|
||||||
optionally followed by a blank separated list of command line options for
|
uses <em>/var/run/lirc/lircd</em>.</p>
|
||||||
that plugin. If <i>options</i> contains any blanks, you need to enclose it
|
</dd>
|
||||||
in quotes, like for example
|
<dt><strong>--localedir=</strong><em>dir</em></dt>
|
||||||
<p><b>vdr -P "abc -a -b xyz"</b></p>
|
<dd>
|
||||||
<p>which would load a plugin named <b>abc</b>, giving it the
|
<p>Search for locale files in <em>dir</em> (default is ./locale).</p>
|
||||||
command line options <b>-a -b xyz</b>. If you want to load
|
</dd>
|
||||||
all available plugins (without any particular options) you can use</p>
|
<dt><strong>-m, --mute</strong></dt>
|
||||||
<p><b>vdr -P "*"</b></p>
|
<dd>
|
||||||
|
<p>Mute audio of the primary DVB device at startup.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--no-kbd</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Don't use the keyboard as an input device.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-p </strong><em>port</em><strong>,
|
||||||
|
--port=</strong><em>port</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Use <em>port</em> for SVDRP. A value of <strong>0</strong> turns off
|
||||||
|
SVDRP. The default SVDRP port is <strong>6419</strong>. You need to edit
|
||||||
|
the file <em>svdrphosts.conf</em> in order to enable access to the SVDRP
|
||||||
|
port from hosts other than the localhosts. Note that this option only
|
||||||
|
changes the TCP port used for SVDRP commands. The UDP port for
|
||||||
|
discovering peer VDRs in the same network is always set to 6419 and
|
||||||
|
can't be changed.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-P </strong><em>options</em><strong>,
|
||||||
|
--plugin=</strong><em>options</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Load a plugin, defined by the given <em>options</em>. The first word
|
||||||
|
in <em>options</em> must be the name of an existing <strong>vdr</strong>
|
||||||
|
plugin, optionally followed by a blank separated list of command line
|
||||||
|
options for that plugin. If <em>options</em> contains any blanks, you
|
||||||
|
need to enclose it in quotes, like for example</p>
|
||||||
|
</dd>
|
||||||
|
</dl>
|
||||||
|
<p><strong>vdr -P "abc -a -b xyz"</strong></p>
|
||||||
|
<p>which would load a plugin named <strong>abc</strong>, giving it the
|
||||||
|
command line options <strong>-a -b xyz</strong>. If you want to load all
|
||||||
|
available plugins (without any particular options) you can use</p>
|
||||||
|
<p><strong>vdr -P "*"</strong></p>
|
||||||
<p>(note the quotes around the asterisk to prevent wildcard
|
<p>(note the quotes around the asterisk to prevent wildcard
|
||||||
expansion).</p>
|
expansion).</p>
|
||||||
|
<dl>
|
||||||
|
<dt><strong>-r </strong><em>cmd</em><strong>,
|
||||||
|
--record=</strong><em>cmd</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Call <em>cmd</em> before and after a recording. See the file
|
||||||
|
<em>INSTALL</em> for more information.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--resdir=</strong><em>dir</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Read resource files from <em>dir</em> (default is to read them from
|
||||||
|
the config directory).</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--showargs[=</strong><em>dir</em><strong>]</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Read command line arguments from <em>dir</em> (default is
|
||||||
|
<em>/etc/vdr/conf.d</em>), display them to the console and exit.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-s </strong><em>cmd</em><strong>,
|
||||||
|
--shutdown=</strong><em>cmd</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Call <em>cmd</em> to shutdown the computer. See the file
|
||||||
|
<em>INSTALL</em> for more information.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--split</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Split edited files at the editing marks. This option is only useful
|
||||||
|
in conjunction with --edit, and must precede that option to have an
|
||||||
|
effect.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-t </strong><em>tty</em><strong>,
|
||||||
|
--terminal=</strong><em>tty</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Set the controlling terminal.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-u </strong><em>user</em><strong>,
|
||||||
|
--user=</strong><em>user</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Run as user <em>user</em> in case vdr was started as user 'root'.
|
||||||
|
Starting vdr as 'root' is necessary if the system time shall be set from
|
||||||
|
the transponder data, but for security reasons vdr can switch to a
|
||||||
|
lesser privileged user id during normal operation. <em>user</em> can be
|
||||||
|
a user name or a numerical id.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--updindex=</strong><em>rec</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Update the index file for the given recording. <em>rec</em> must be
|
||||||
|
the full path name of an existing recording. The recording must be in TS
|
||||||
|
format. If the recording already has an index file, it will be checked
|
||||||
|
whether it is complete, and will be updated if it isn't. If there is no
|
||||||
|
index file yet, a new one will be generated. The program will return
|
||||||
|
immediately after updating the index. Note that using this option while
|
||||||
|
another instance of VDR is currently replaying the given recording, or
|
||||||
|
if the recording has not been finished yet, may lead to unexpected
|
||||||
|
results.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--userdump</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Allow coredumps if -u is given (only for debugging).</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>--vfat</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>For backwards compatibility (same as --dirnames= 250,40,1).</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-v </strong><em>dir</em><strong>,
|
||||||
|
--video=</strong><em>dir</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Use <em>dir</em> as video directory. The default is
|
||||||
|
<em>/video</em>.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-V, --version</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Print version information and exit.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>-w </strong><em>sec</em><strong>,
|
||||||
|
--watchdog=</strong><em>sec</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Activate the watchdog timer with a timeout of <em>sec</em> seconds. A
|
||||||
|
value of <strong>0</strong> (default) disables the watchdog.</p>
|
||||||
</dd>
|
</dd>
|
||||||
<dt><h3><b>-r </b><i>cmd</i><b>, --record=</b><i>cmd</i></h3></dt>
|
|
||||||
<dd>Call <i>cmd</i> before and after a recording. See the file <i>INSTALL</i>
|
|
||||||
for more information.</dd>
|
|
||||||
<dt><h3><b>--resdir=</b><i>dir</i></h3></dt>
|
|
||||||
<dd>Read resource files from <i>dir</i> (default is to read them from the
|
|
||||||
config directory).</dd>
|
|
||||||
<dt><h3><b>--showargs[=</b><i>dir</i><b>]</b></h3></dt>
|
|
||||||
<dd>Read command line arguments from <i>dir</i> (default is
|
|
||||||
<i>/etc/vdr/conf.d</i>), display them to the console and exit.</dd>
|
|
||||||
<dt><h3><b>-s </b><i>cmd</i><b>, --shutdown=</b><i>cmd</i></h3></dt>
|
|
||||||
<dd>Call <i>cmd</i> to shutdown the computer. See the file <i>INSTALL</i> for
|
|
||||||
more information.</dd>
|
|
||||||
<dt><h3><b>--split</b></h3></dt>
|
|
||||||
<dd>Split edited files at the editing marks. This option is only useful in
|
|
||||||
conjunction with --edit, and must precede that option to have an
|
|
||||||
effect.</dd>
|
|
||||||
<dt><h3><b>-t </b><i>tty</i><b>, --terminal=</b><i>tty</i></h3></dt>
|
|
||||||
<dd>Set the controlling terminal.</dd>
|
|
||||||
<dt><h3><b>-u </b><i>user</i><b>, --user=</b><i>user</i></h3></dt>
|
|
||||||
<dd>Run as user <i>user</i> in case vdr was started as user 'root'. Starting
|
|
||||||
vdr as 'root' is necessary if the system time shall be set from the
|
|
||||||
transponder data, but for security reasons vdr can switch to a lesser
|
|
||||||
privileged user id during normal operation. <i>user</i> can be a user name
|
|
||||||
or a numerical id.</dd>
|
|
||||||
<dt><h3><b>--updindex=</b><i>rec</i></h3></dt>
|
|
||||||
<dd>Update the index file for the given recording. <i>rec</i> must be the full
|
|
||||||
path name of an existing recording. The recording must be in TS format. If
|
|
||||||
the recording already has an index file, it will be checked whether it is
|
|
||||||
complete, and will be updated if it isn't. If there is no index file yet,
|
|
||||||
a new one will be generated. The program will return immediately after
|
|
||||||
updating the index. Note that using this option while another instance of
|
|
||||||
VDR is currently replaying the given recording, or if the recording has
|
|
||||||
not been finished yet, may lead to unexpected results.</dd>
|
|
||||||
<dt><h3><b>--userdump</b></h3></dt>
|
|
||||||
<dd>Allow coredumps if -u is given (only for debugging).</dd>
|
|
||||||
<dt><h3><b>--vfat</b></h3></dt>
|
|
||||||
<dd>For backwards compatibility (same as --dirnames= 250,40,1).</dd>
|
|
||||||
<dt><h3><b>-v </b><i>dir</i><b>, --video=</b><i>dir</i></h3></dt>
|
|
||||||
<dd>Use <i>dir</i> as video directory. The default is <i>/video</i>.</dd>
|
|
||||||
<dt><h3><b>-V, --version</b></h3></dt>
|
|
||||||
<dd>Print version information and exit.</dd>
|
|
||||||
<dt><h3><b>-w </b><i>sec</i><b>, --watchdog=</b><i>sec</i></h3></dt>
|
|
||||||
<dd>Activate the watchdog timer with a timeout of <i>sec</i> seconds. A value
|
|
||||||
of <b>0</b> (default) disables the watchdog.</dd>
|
|
||||||
</dl>
|
</dl>
|
||||||
<p>If started without any options, vdr tries to read command line
|
<p>If started without any options, vdr tries to read command line
|
||||||
options from files named '*.conf' in the directory /etc/vdr/conf.d. Files
|
options from files named '*.conf' in the directory /etc/vdr/conf.d.
|
||||||
are read in alphabetical order. See vdr(5) for details.</p>
|
Files are read in alphabetical order. See vdr(5) for details.</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>SIGNALS</h1>
|
<h1>SIGNALS</h1>
|
||||||
<dl>
|
<dl>
|
||||||
<dt><h3><b>SIGINT, SIGTERM</b></h3></dt>
|
<dt><strong>SIGINT, SIGTERM</strong></dt>
|
||||||
<dd>Program exits with status 0.</dd>
|
<dd>
|
||||||
<dt><h3><b>SIGHUP</b></h3></dt>
|
<p>Program exits with status 0.</p>
|
||||||
<dd>Program exits with status 1. This can be used to force a reload, for
|
</dd>
|
||||||
example if an update has been installed.</dd>
|
<dt><strong>SIGHUP</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Program exits with status 1. This can be used to force a reload, for
|
||||||
|
example if an update has been installed.</p>
|
||||||
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>EXIT STATUS</h1>
|
<h1>EXIT STATUS</h1>
|
||||||
<dl>
|
<dl>
|
||||||
<dt><h3><b>0</b></h3></dt>
|
<dt><strong>0</strong></dt>
|
||||||
<dd>Successful program execution.</dd>
|
<dd>
|
||||||
<dt><h3><b>1</b></h3></dt>
|
<p>Successful program execution.</p>
|
||||||
<dd>An error has been detected which requires the DVB driver and <b>vdr</b> to
|
</dd>
|
||||||
be reloaded.</dd>
|
<dt><strong>1</strong></dt>
|
||||||
<dt><h3><b>2</b></h3></dt>
|
<dd>
|
||||||
<dd>An non-recoverable error has been detected, <b>vdr</b> has given up.</dd>
|
<p>An error has been detected which requires the DVB driver and
|
||||||
|
<strong>vdr</strong> to be reloaded.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><strong>2</strong></dt>
|
||||||
|
<dd>
|
||||||
|
<p>An non-recoverable error has been detected, <strong>vdr</strong> has
|
||||||
|
given up.</p>
|
||||||
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>FILES</h1>
|
<h1>FILES</h1>
|
||||||
<dl>
|
<dl>
|
||||||
<dt><h3><i>channels.conf</i></h3></dt>
|
<dt><em>channels.conf</em></dt>
|
||||||
<dd>Channel configuration.</dd>
|
<dd>
|
||||||
<dt><h3><i>timers.conf</i></h3></dt>
|
<p>Channel configuration.</p>
|
||||||
<dd>Timer configuration.</dd>
|
</dd>
|
||||||
<dt><h3><i>setup.conf</i></h3></dt>
|
<dt><em>timers.conf</em></dt>
|
||||||
<dd>User definable setup.</dd>
|
<dd>
|
||||||
<dt><h3><i>commands.conf</i></h3></dt>
|
<p>Timer configuration.</p>
|
||||||
<dd>User definable commands (executed from the <b>Commands</b> menu).</dd>
|
</dd>
|
||||||
<dt><h3><i>svdrphosts.conf</i></h3></dt>
|
<dt><em>setup.conf</em></dt>
|
||||||
<dd>SVDRP host configuration, defining which hosts or networks are given
|
<dd>
|
||||||
access to the SVDRP port.</dd>
|
<p>User definable setup.</p>
|
||||||
<dt><h3><i>marks</i></h3></dt>
|
</dd>
|
||||||
<dd>Contains the editing marks defined for a recording.</dd>
|
<dt><em>commands.conf</em></dt>
|
||||||
<dt><h3><i>info</i></h3></dt>
|
<dd>
|
||||||
<dd>Contains a description of the recording.</dd>
|
<p>User definable commands (executed from the <strong>Commands</strong>
|
||||||
<dt><h3><i>resume</i></h3></dt>
|
menu).</p>
|
||||||
<dd>Contains the index into the recording where the last replay session left
|
</dd>
|
||||||
off.</dd>
|
<dt><em>svdrphosts.conf</em></dt>
|
||||||
<dt><h3><i>index</i></h3></dt>
|
<dd>
|
||||||
<dd>Contains the file number, offset and type of each frame of the
|
<p>SVDRP host configuration, defining which hosts or networks are given
|
||||||
recording.</dd>
|
access to the SVDRP port.</p>
|
||||||
<dt><h3><i>remote.conf</i></h3></dt>
|
</dd>
|
||||||
<dd>Contains the key assignments for the remote control.</dd>
|
<dt><em>marks</em></dt>
|
||||||
<dt><h3><i>keymacros.conf</i></h3></dt>
|
<dd>
|
||||||
<dd>Contains user defined remote control key macros.</dd>
|
<p>Contains the editing marks defined for a recording.</p>
|
||||||
<dt><h3><i>00001.ts </i>... <i>65535.ts</i></h3></dt>
|
</dd>
|
||||||
<dd>The actual data files of a recording.</dd>
|
<dt><em>info</em></dt>
|
||||||
<dt><h3><i>epg.data</i></h3></dt>
|
<dd>
|
||||||
<dd>Contains all current EPG data. Can be used for external processing and
|
<p>Contains a description of the recording.</p>
|
||||||
will also be read at program startup to have the full EPG data available
|
</dd>
|
||||||
immediately.</dd>
|
<dt><em>resume</em></dt>
|
||||||
<dt><h3><i>donerecs.data</i></h3></dt>
|
<dd>
|
||||||
<dd>Contains the names of recordings that have been done by pattern timers
|
<p>Contains the index into the recording where the last replay session
|
||||||
with '@' as the first character of the pattern. File names are appended to
|
left off.</p>
|
||||||
this file after a recording has finished, and the entire file is read upon
|
</dd>
|
||||||
startup of VDR.</dd>
|
<dt><em>index</em></dt>
|
||||||
<dt><h3><i>.update</i></h3></dt>
|
<dd>
|
||||||
<dd>If this file is present in the video directory, its last modification time
|
<p>Contains the file number, offset and type of each frame of the
|
||||||
will be used to trigger an update of the list of recordings in the
|
recording.</p>
|
||||||
"Recordings" menu.</dd>
|
</dd>
|
||||||
|
<dt><em>remote.conf</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Contains the key assignments for the remote control.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><em>keymacros.conf</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Contains user defined remote control key macros.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><em>00001.ts </em>... <em>65535.ts</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>The actual data files of a recording.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><em>epg.data</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Contains all current EPG data. Can be used for external processing
|
||||||
|
and will also be read at program startup to have the full EPG data
|
||||||
|
available immediately.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><em>donerecs.data</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Contains the names of recordings that have been done by pattern
|
||||||
|
timers with '@' as the first character of the pattern. File names are
|
||||||
|
appended to this file after a recording has finished, and the entire
|
||||||
|
file is read upon startup of VDR.</p>
|
||||||
|
</dd>
|
||||||
|
<dt><em>.update</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>If this file is present in the video directory, its last modification
|
||||||
|
time will be used to trigger an update of the list of recordings in the
|
||||||
|
"Recordings" menu.</p>
|
||||||
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>SEE ALSO</h1>
|
<h1>SEE ALSO</h1>
|
||||||
<p><b>vdr</b>(5),<b>svdrpsend</b>(1)</p>
|
<p><strong>vdr</strong>(5),<strong>svdrpsend</strong>(1)</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>AUTHOR</h1>
|
<h1>AUTHOR</h1>
|
||||||
<p>Written by Klaus Schmidinger, with contributions from many others.
|
<p>Written by Klaus Schmidinger, with contributions from many others.
|
||||||
See the file <i>CONTRIBUTORS</i> in the <b>vdr</b> source distribution.</p>
|
See the file <em>CONTRIBUTORS</em> in the <strong>vdr</strong> source
|
||||||
</section>
|
distribution.</p>
|
||||||
<section>
|
|
||||||
<h1>REPORTING BUGS</h1>
|
<h1>REPORTING BUGS</h1>
|
||||||
<p>Report bugs to <vdr-bugs@tvdr.de>.</p>
|
<p>Report bugs to <vdr-bugs@tvdr.de>.</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>COPYRIGHT</h1>
|
<h1>COPYRIGHT</h1>
|
||||||
<p>Copyright © 2021 Klaus Schmidinger.</p>
|
<p>Copyright © 2021 Klaus Schmidinger.</p>
|
||||||
<p>This is free software; see the source for copying conditions.
|
<p>This is free software; see the source for copying conditions. There
|
||||||
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
|
is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
||||||
PARTICULAR PURPOSE.</p>
|
PURPOSE.</p>
|
||||||
</section>
|
|
||||||
</div>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td>27 Dec 2021</td>
|
|
||||||
<td>2.6</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
File diff suppressed because it is too large
Load Diff
@ -1,58 +1,39 @@
|
|||||||
<table>
|
|
||||||
<tr>
|
<header>
|
||||||
<td>svdrpsend(1)</td>
|
<h1>svdrpsend</h1>
|
||||||
<td>Video Disk Recorder</td>
|
<p>27 Dec 2021</p>
|
||||||
<td>svdrpsend(1)</td>
|
</header>
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
<div>
|
|
||||||
<section>
|
|
||||||
<h1>NAME</h1>
|
<h1>NAME</h1>
|
||||||
<p>svdrpsend - sends commands to VDR</p>
|
<p>svdrpsend - sends commands to VDR</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>SYNOPSIS</h1>
|
<h1>SYNOPSIS</h1>
|
||||||
<p>svdrpsend [<i>options</i>] <i>command</i></p>
|
<p>svdrpsend [<em>options</em>] <em>command</em></p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>DESCRIPTION</h1>
|
<h1>DESCRIPTION</h1>
|
||||||
<p>This program sends commands to VDR (the Video Disk Recorder) and
|
<p>This program sends commands to VDR (the Video Disk Recorder) and
|
||||||
displays the result. A list of available commands can be shown by sending
|
displays the result. A list of available commands can be shown by
|
||||||
the HELP command.</p>
|
sending the HELP command.</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>OPTIONS</h1>
|
<h1>OPTIONS</h1>
|
||||||
<dl>
|
<dl>
|
||||||
<dt><h3><b>-d</b> <i>hostname</i></h3></dt>
|
<dt><strong>-d</strong> <em>hostname</em></dt>
|
||||||
<dd>Accesses the VDR at the specified <i>hostname</i> (default is
|
<dd>
|
||||||
localhost).</dd>
|
<p>Accesses the VDR at the specified <em>hostname</em> (default is
|
||||||
<dt><h3><b>-p</b> <i>port</i></h3></dt>
|
localhost).</p>
|
||||||
<dd>Uses the SVDRP port number <i>port</i> (default is 6419).</dd>
|
</dd>
|
||||||
|
<dt><strong>-p</strong> <em>port</em></dt>
|
||||||
|
<dd>
|
||||||
|
<p>Uses the SVDRP port number <em>port</em> (default is 6419).</p>
|
||||||
|
</dd>
|
||||||
</dl>
|
</dl>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>EXAMPLES</h1>
|
<h1>EXAMPLES</h1>
|
||||||
<p>To request the available commands from the VDR running on the
|
<p>To request the available commands from the VDR running on the local
|
||||||
local host:</p>
|
host:</p>
|
||||||
<p>svdrpsend HELP</p>
|
<p>svdrpsend HELP</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>AUTHORS</h1>
|
<h1>AUTHORS</h1>
|
||||||
<p>Written by Tobias Grimm <tg@e-tobi.net></p>
|
<p>Written by Tobias Grimm <tg@e-tobi.net></p>
|
||||||
<p>Permission is granted to copy, distribute and/or modify this
|
<p>Permission is granted to copy, distribute and/or modify this document
|
||||||
document under the terms of the GNU General Public License, Version 2 any
|
under the terms of the GNU General Public License, Version 2 any later
|
||||||
later version published by the Free Software Foundation.</p>
|
version published by the Free Software Foundation.</p>
|
||||||
<p>On Debian systems, the complete text of the GNU General Public
|
<p>On Debian systems, the complete text of the GNU General Public
|
||||||
License can be found in /usr/share/common-licenses/GPL.</p>
|
License can be found in /usr/share/common-licenses/GPL.</p>
|
||||||
</section>
|
|
||||||
<section>
|
|
||||||
<h1>SEE ALSO</h1>
|
<h1>SEE ALSO</h1>
|
||||||
<p>vdr(1), vdr(5)</p>
|
<p>vdr(1), vdr(5)</p>
|
||||||
</section>
|
|
||||||
</div>
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td>27 Dec 2021</td>
|
|
||||||
<td>2.6</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user