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
       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] [-D] [-l] [-s port]	[-r user] [-b ipaddr] [-x display] de-
       vicenames

       floppyd is always associated with an X server.  It runs on the same ma-
       chine 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      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 back-
	      ground 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	hitch-
	      hiker: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  pa-
       rameter	of  the	 device	 description  is taken to be a remote address.
       It's   format   is   the	  following:	hostname:displaynumber[/[base-
       port][/drive]].	When  using  this entry, mtools	connects to port base-
       port+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', lis-
       tening 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 dae-
       mon, 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 flop-
       pyd.  This is because the port is opened	by inetd.conf, and hence flop-
       pyd cannot know its number to interfere the display number.

       On the client side, insert the following	into your `~/.mtoolsrc'	to de-
       fine 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	 addi-
       tional 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 represen-
       tation 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 fol-
	      lowing 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 conventions used	in info.

mtools-4.0.47			    19Jan25			    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+14.3.quarterly>

home | help