and running




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] device­
       name [displaynames]

       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 connec­
       tion 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

       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  Xau­
       thority 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
              Run the server under as the given user

       l      Do not generate local default display names

       devicename  is  the  name of the device node to be opened.
       Default is /dev/fd0.

       displaynames is a list of display names to connect to  for
       authentication.   All displays in the list are tried until
       one is found that grants  access  or  until  the  list  is
       exhausted.   If  no  list  is supplied, the a display name
       list based on the ip address supplied using the -b flag is
       constructed: ipaddr:n.0.

       *  :n.0
               If  floppyd  is started from inetd, the address of
              the socket  used  for  stdin  is  used  as  a  bind
              address.

        If  no  bind  address  is supplied, a list containing the
       following 3 items is constructed:

       *  hostname:n.0

       *  localhost:n.0

       *  :n.0

        n is the display number  derived  from  the  port  number
       (port  - 5703 modulo 10). The local items (localhost:0 and
       :0) are not constructed if the -l flag is given.



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].  When
       using  this  entry,  mtools connects to port baseport+dis­
       playnumber at hostname. By default baseport is 5703.



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


       vices':

          # 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 /dev/fd1



        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





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  crossrefer­
       ences,  footnotes and indices are lost in this translation
       process.  Indeed, these items have no  appropriate  repre­
       sentation in the manpage format.  Moreover, not all infor­
       mation 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
                     ./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.




mtools-3.9.8                 02Nov02                   floppyd(1)

Man(1) output converted with man2html