Manpages - 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=] [=-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 thex
attribute is present norDISPLAY
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.