Table of Contents
tvpsh — Command line shell to interface tvpvrd daemon
The tvpsh(1) is a command line shell meant to interface the tvpvrd daemon. The program offers full command line editing (emulating emacs command set) as well as history. This makes it the preferred way to inteface with the daemon for the full feature set. The alternative command line way is to connect directly to the daemon port using telnet, however the normal telnet does not allow any command line editing.
The most user friendly way is probably still to use the basic Web-interface of the daemon. However, only a subset of the available commands are implemented in the Web-client in order to keep it easy to use.
The shell can be run either on the same server as the daemon in which case it can simply be started with
$>tvpsh
or it can be run on a different computer in which case the tvpvrd server must be specified either on the command line as
$> tvpsh -s 192.168.010 -p 9301
or by storing the server and port setting in the tvpsh config
file stored in the users home directory. The config file is named
".tvpshrc
" and should be stored in the home
directory.
When the daemon is run on the same server the shell will read the necessary informatoin from the daemons config file after looking first for the tvpsh config file in the users home directory.
One possible wasy to use the shell is to use it as a system login shell. In this way it will be possible to login directly to the server by using, for example, ssh and connecting as a dedicated user who uses tvpsh as default login shell.
In order to do this there are two things that must be done:
Add a new user to the server and specify tvpsh as
the login shell. This is done by adding a line in the
/etc/passwd
file. For example as
pvr:x:0:0:tvpvrd shell user:/home/pvr:/usr/bin/tvpsh
The above line creates a new user called pvr which uses tvpsh as login shell. (The 'x' in the password field indicates that the system is using shadow passwords.). You can also use the system tools you are comfortable with in order to create a new user.
Allow tvpsh to be used as system shell by adding it
to the list of allowed system shells in
'/etc/shells
'
The following command line arguments are supported when starting the shell
-s
, --server
IP-addressSpecify the server that is running tvpvrd. Default value is localhost.
-p
, --port
portnumberTCP/IP port where the tvpvrd server is listening. If the shell is run on the same server as the daemon then the port will be automatically determined from the tvpvrd config file.
-h
, --help
Print a short help and exit.
-v
, --version
Print program version information and exit.
SourceForge: <http://sourceforge.net/projects/tvpvrd/>
ivtv-driver: <http://ivtvdriver.org/>
Video for Linux: <http://linux.bytesex.org/v4l2/>