


rtspd(8)                                                 rtspd(8)


NAME
       rtspd - RTSP Proxy Reference Implementation


SYNOPSIS
       rtspd  [ -p port ] [ -f host:port ] [ -c dir ] [ -u user ]
       [ -h ] [ -v ]


DESCRIPTION
       Rtspd is a reference  implementation  of  an  application-
       level  RTSP  proxy.  This is meant to serve as a reference
       for those writing firewall software.   It  currently  sup-
       ports the following unicast transports: X-REAL-RTP/UDP, X-
       REAL-RTP/TCP, RTP/AVP/UDP and RTP/AVP/TCP.


OPTIONS
       -p port     Run as a server bound  to  the  specified  TCP
                   port  (specified  by  number  or  name).   The
                   default port is  a  compile-time  option,  and
                   currently  defaults to port 554.  By using the
                   -h option, you can determine  the  compiled-in
                   default.

       -f host:port
                   Forward  all  network traffic to another proxy
                   at the specified  host  and  TCP  port.   This
                   allows  proxies  to be "chained" together, and
                   may be necessary in situations where there are
                   multiple  firewalls between the player and the
                   server.   For  example,  using  "-f  foo.some-
                   place.com:7654",  an rtspd proxy would forward
                   all traffic to port 7654  on  the  host  named
                   "foo.someplace.com".    If  there  is  another
                   application-level RTSP proxy  running  on  the
                   specified  port  of that machine, it will for-
                   ward the traffic on, either to a final  server
                   or  to  another proxy.  The host may be speci-
                   fied as a hostname or an IP address.  The port
                   may be specified as a number or as a name from
                   the services(8) file.

       -c dir      Perform a chroot() to the specified  directory
                   for  enhanced security.  This directory should
                   be the top of an already-configured "sandbox".
                   Only the 'root' user may use this option.

       -u user     Change to the specified user at startup.  This
                   is intended for use with the -c option.   This
                   is a username, not a numeric user-id (an exam-
                   ple would be 'nobody'.)  Only the 'root'  user
                   may use this option.




                           October 1998                         1





rtspd(8)                                                 rtspd(8)


       -h          Print a list of valid command-line options and
                   their descriptions.

       -v          Print version information.


USAGE INFORMATION
       Status information is logged via  syslog(3)  at  the  dae-
       mon.error,   daemon.info,  and  daemon.debug  log  levels.
       Information logged includes proxy  startup  and  shutdown,
       client address, server address and port, and any important
       error messages.  You may wish to  alter  the  behavior  of
       syslog(3) using syslog.conf(5).  To view the status infor-
       mation, you may wish to use the following:

              tail -f /var/log/messages

       If the proxy is started by the  "root"  user  and  the  -u
       switch is not specified, it will automatically setuid() to
       the user "nobody",  as  if  the  command-line  switch  "-u
       nobody" had been used.


FILES
       /var/log/messages
              On  some versions of Unix syslogd(8) may be logging
              to /var/log/syslog or another file, and  either  of
              these  files  may  be in /var/adm or another direc-
              tory.

SEE ALSO
       chroot(2),   services(5),   setuid(2),   syslog(3),   sys-
       log.conf(5), syslogd(8)


STANDARDS
       Real  Time  Streaming Protocol (RTSP; RFC 2326), Real Time
       Transport Protocol (RTP; RFC 1889)



















                           October 1998                         2


