Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
floppyd(1)		     General Commands Manual		      floppyd(1)

Name
     floppyd - floppy daemon for remote access to floppy drive

Note of warning
     This  manpage  has been automatically generated from mtools's texinfo docu-
     mentation, 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  dis-
     play to remote clients.  It has the following syntax:

     floppyd [-d] [-D] [-l] [-s port] [-r user] [-b ipaddr] [-x display] device-
     names

     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.   Flop-
     pyd  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	    Server  mode.  Floppyd runs its own server loop.  Do not supply this
	    if you start floppyd from inetd.conf

     D	    Do not daemonize. Floppyd will not put itself  into  the  background
	    even if started in server mode.

     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 DIS-
	    PLAY 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 de-
     fault baseport is 5703. The drive parameter is to distinguish among  multi-
     ple  drives associated with a single display (only mtools versions more re-
     cent than 3.9.11)

Examples:
      The following starts a floppy daemon giving access to `/dev/fd0',  listen-
     ing 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 docu-
     mentation. 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/man-
     ual/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 con-
     ventions used in info.

mtools-4.0.49			     14Jun25			      floppyd(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=floppyd&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help