Name

       floppyd - floppy daemon for remote access to floppy drive

Note of warning

       This manpage has been automatically generated from mtools's texinfo documentation, and may
       not be entirely accurate or complete.  See the end of this man page for details.

Description

       Floppyd is used as a server to grant access to the floppy drive to clients  running  on  a
       remote  machine,  just  as an X server grants access to the display to remote clients.  It
       has the following syntax:

       floppyd [-d] [-l] [-s port] [-r user] [-b ipaddr] [-x display] devicenames

       floppyd is always associated with an X server.  It runs on  the  same  machine  as  its  X
       server, and listens on port 5703 and above.

Authentication

       floppyd  authenticates  remote clients using the Xauthority protocol. Xhost authentication
       is not supported. Each floppyd is associated with an  X  server.   When  a  remote  client
       attempts  to  connect to floppyd, it sends floppyd the X authority record corresponding to
       floppyd's X server.  Floppyd in turn then tries to open up a connection to the X server in
       order  to  verify the authenticity of the xauth record.  If the connection to the X server
       succeeds, the client is granted access.  DISPLAY.

       Caution: In order to make authentication work correctly, the  local  host  should  not  be
       listed in the xhost list of allowed hosts.
        Indeed, hosts listed in xhost do not need a correct Xauthority cookie to connect to the X
       server. As floppyd runs on the same host as the X server, all its probe  connection  would
       succeed  even  for  clients  who supplied a bad cookie.  This means that your floppy drive
       would be open to the world, i.e. a huge security hole.
        If your X server does not allow you to remove localhost:0 and :0 from the xhost list, you
       can prevent floppyd from probing those display names with the -l option.

Command line options

       d      Daemon  mode.  Floppyd  runs  its own server loop.  Do not supply this if you start
              floppyd from inetd.conf

       s  port
              Port number for daemon mode.  Default is 5703 + displaynumber.  This  flag  implies
              daemon mode.  For example, for display hitchhiker:5, the port would be 5708.

       b  ipaddr
              Bind address (for multi homed hosts). This flag implies daemon mode

       r user
              Run the server under as the given user

       x display
              X  display  to  use  for authentication. By default, this is taken from the DISPLAY
              variable. If neither the x attribute is present nor DISPLAY is  set,  floppyd  uses
              :0.0.

       devicenames is a list of device nodes to be opened.  Default is /dev/fd0. Multiple devices
       are only supported on mtools versions newer than 3.9.11.

Connecting to floppyd

        In order to use  floppyd,  add  the  flag  remote  to  the  device  description  in  your
       `~/.mtoolsrc'  file.   If  the  flag  remote  is  given,  the file parameter of the device
       description  is  taken  to  be  a  remote  address.   It's  format   is   the   following:
       hostname:displaynumber[/[baseport][/drive]].  When  using  this  entry, mtools connects to
       port baseport+displaynumber at hostname. By default baseport is 5703. The drive  parameter
       is  to  distinguish  among  multiple  drives associated with a single display (only mtools
       versions more recent than 3.9.11)

Examples:

        The following starts a floppy daemon  giving  access  to  `/dev/fd0',  listening  on  the
       default port 5703, tied to the default X servers:

          floppyd -d /dev/fd0

        Each  of the following starts a floppy daemon giving access to `/dev/fd1', tied to the :1
       local X servers, and listening on port 5704. We  assume  that  the  local  host  is  named
       hitchhiker.

          floppyd -d /dev/fd0
          floppyd -d -x :1 -p 5704 /dev/fd0

        If  you  want  to  start  floppyd  by inetd instead of running it as a daemon, insert the
       following lines into `/etc/services':

          # floppy daemon
          floppyd-0    5703/tcp    # floppy daemon for X server :0
          floppyd-1    5704/tcp    # floppy daemon for X server :1

        And insert the following into `/etc/inetd.conf' (assuming that you have  defined  a  user
       named floppy in your `/etc/passwd'):

          # floppy daemon
          floppyd-0 stream  tcp  wait  floppy  /usr/sbin/floppyd floppyd /dev/fd0
          floppyd-1 stream  tcp  wait  floppy  /usr/sbin/floppyd floppyd -x :1 /dev/fd0

        Note that you need to supply the X display names for the second floppyd.  This is because
       the port is opened by inetd.conf, and hence floppyd cannot know its  number  to  interfere
       the display number.

       On  the client side, insert the following into your `~/.mtoolsrc' to define a drive letter
       accessing floppy drive in your X terminal:

          drive x: file="$DISPLAY" remote

       If your X terminal has more than one drive,  you  may  access  the  additional  drives  as
       follows:

          drive y: file="$DISPLAY//1" remote
          drive z: file="$DISPLAY//2" remote

See Also

       Mtools' texinfo doc

Viewing the texi doc

       This  manpage  has  been  automatically  generated  from  mtools's  texinfo documentation.
       However, this process is only approximative, and  some  items,  such  as  crossreferences,
       footnotes  and  indices are lost in this translation process.  Indeed, these items have no
       appropriate representation in the manpage format.  Moreover, not all information has  been
       translated  into  the  manpage  version.   Thus  I strongly advise you to use the original
       texinfo doc.  See the end of this manpage for instructions how to view the texinfo doc.

       *      To generate a printable copy from the texinfo doc, run the following commands:

                     ./configure; make dvi; dvips mtools.dvi

       *      To generate a html copy,  run:

                     ./configure; make html

       A premade html can be found at `http://www.gnu.org/software/mtools/manual/mtools.html'

       *      To generate an info copy (browsable using emacs' info mode), run:

                     ./configure; make info

       The texinfo doc looks most pretty when printed or as html.  Indeed, in  the  info  version
       certain examples are difficult to read due to the quoting conventions used in info.