Alistair Delva | beaee83 | 2021-02-24 11:27:23 -0800 | [diff] [blame] | 1 | '\" t |
| 2 | .TH floppyd 1 "28Nov20" mtools-4.0.26 |
| 3 | .SH Name |
| 4 | floppyd - floppy daemon for remote access to floppy drive |
| 5 | '\" t |
| 6 | .de TQ |
| 7 | .br |
| 8 | .ns |
| 9 | .TP \\$1 |
| 10 | .. |
| 11 | |
| 12 | .tr \(is' |
| 13 | .tr \(if` |
| 14 | .tr \(pd" |
| 15 | |
| 16 | .SH Note\ of\ warning |
| 17 | This manpage has been automatically generated from mtools's texinfo |
| 18 | documentation, and may not be entirely accurate or complete. See the |
| 19 | end of this man page for details. |
| 20 | .PP |
| 21 | .SH Description |
| 22 | .PP |
| 23 | \&\fR\&\f(CWFloppyd\fR is used as a server to grant access to the floppy drive |
| 24 | to clients running on a remote machine, just as an X server grants |
| 25 | access to the display to remote clients. It has the following syntax: |
| 26 | .PP |
| 27 | \&\fR\&\f(CWfloppyd\fR [\fR\&\f(CW-d\fR] [\fR\&\f(CW-l\fR] [\fR\&\f(CW-s\fR \fIport\fR] [\fR\&\f(CW-r\fR |
| 28 | \&\fIuser\fR] [\fR\&\f(CW-b\fR \fIipaddr\fR] [\fR\&\f(CW-x\fR \fIdisplay\fR] \fIdevicenames\fR |
| 29 | .PP |
| 30 | \&\fR\&\f(CWfloppyd\fR is always associated with an X server. It runs on the |
| 31 | same machine as its X server, and listens on port 5703 and above. |
| 32 | .PP |
| 33 | .SH Authentication |
| 34 | .PP |
| 35 | \&\fR\&\f(CWfloppyd\fR authenticates remote clients using the \fR\&\f(CWXauthority\fR |
| 36 | protocol. Xhost authentication is not supported. Each floppyd is |
| 37 | associated with an X server. When a remote client attempts to connect |
| 38 | to floppyd, it sends floppyd the X authority record corresponding to |
| 39 | floppyd's X server. Floppyd in turn then tries to open up a connection |
| 40 | to the X server in order to verify the authenticity of the xauth record. |
| 41 | If the connection to the X server succeeds, the client is granted |
| 42 | access. |
| 43 | \&\fR\&\f(CWDISPLAY\fR. |
| 44 | .PP |
| 45 | \&\fBCaution\fR: In order to make authentication work correctly, the |
| 46 | local host should \fBnot\fR be listed in the \fR\&\f(CWxhost\fR list of |
| 47 | allowed hosts. |
| 48 | Indeed, hosts listed in \fR\&\f(CWxhost\fR do not need a correct |
| 49 | \&\fR\&\f(CWXauthority\fR cookie to connect to the X server. As \fR\&\f(CWfloppyd\fR |
| 50 | runs on the same host as the X server, all its probe connection would |
| 51 | succeed even for clients who supplied a bad cookie. This means that |
| 52 | your floppy drive would be open to the world, i.e. a huge security hole. |
| 53 | If your X server does not allow you to remove \fR\&\f(CWlocalhost:0\fR and |
| 54 | \&\fR\&\f(CW:0\fR from the \fR\&\f(CWxhost\fR list, you can prevent floppyd from |
| 55 | probing those display names with the \fR\&\f(CW-l\fR option. |
| 56 | .PP |
| 57 | .SH Command\ line\ options |
| 58 | .TP |
| 59 | \&\fR\&\f(CWd\fR\ |
| 60 | Daemon mode. Floppyd runs its own server loop. Do not supply this if |
| 61 | you start floppyd from \fR\&\f(CWinetd.conf\fR |
| 62 | .TP |
| 63 | \&\fR\&\f(CWs\ \ \fIport\fR\&\f(CW\fR\ |
| 64 | Port number for daemon mode. Default is 5703 + \fIdisplaynumber\fR. |
| 65 | This flag implies daemon mode. For example, for display |
| 66 | \&\fR\&\f(CWhitchhiker:5\fR, the port would be 5708. |
| 67 | .TP |
| 68 | \&\fR\&\f(CWb\ \ \fIipaddr\fR\&\f(CW\fR\ |
| 69 | Bind address (for multi homed hosts). This flag implies daemon mode |
| 70 | .TP |
| 71 | \&\fR\&\f(CWr\ \fIuser\fR\&\f(CW\fR\ |
| 72 | Run the server under as the given user |
| 73 | .TP |
| 74 | \&\fR\&\f(CWx\ \fIdisplay\fR\&\f(CW\fR\ |
| 75 | X display to use for authentication. By default, this is taken from the |
| 76 | \&\fR\&\f(CWDISPLAY\fR variable. If neither the \fR\&\f(CWx\fR attribute is present |
| 77 | nor \fR\&\f(CWDISPLAY\fR is set, floppyd uses \fR\&\f(CW:0.0\fR. |
| 78 | .PP |
| 79 | \&\fIdevicenames\fR is a list of device nodes to be opened. Default |
| 80 | is \fR\&\f(CW/dev/fd0\fR. Multiple devices are only supported on mtools |
| 81 | versions newer than 3.9.11. |
| 82 | .PP |
| 83 | .SH Connecting\ to\ floppyd |
| 84 | .PP |
| 85 | In order to use floppyd, add the flag \fR\&\f(CWremote\fR to the device |
| 86 | description in your \fR\&\f(CW\(if~/.mtoolsrc\(is\fR file. If the flag \fR\&\f(CWremote\fR |
| 87 | is given, the \fR\&\f(CWfile\fR parameter of the device description is taken |
| 88 | to be a remote address. It's format is the following: |
| 89 | \&\fIhostname\fR\fR\&\f(CW:\fR\fIdisplaynumber\fR[\fR\&\f(CW/\fR[\fIbaseport\fR][\fR\&\f(CW/\fR\fIdrive\fR]]. When |
| 90 | using this entry, mtools connects to port |
| 91 | \&\fIbaseport\fR+\fIdisplaynumber\fR at \fIhostname\fR. By default |
| 92 | \&\fIbaseport\fR is 5703. The drive parameter is to distinguish among |
| 93 | multiple drives associated with a single display (only mtools versions |
| 94 | more recent than 3.9.11) |
| 95 | .PP |
| 96 | .SH Examples: |
| 97 | .PP |
| 98 | The following starts a floppy daemon giving access to \fR\&\f(CW\(if/dev/fd0\(is\fR, |
| 99 | listening on the default port 5703, tied to the default X servers: |
| 100 | .PP |
| 101 | |
| 102 | .nf |
| 103 | .ft 3 |
| 104 | .in +0.3i |
| 105 | floppyd -d /dev/fd0 |
| 106 | .fi |
| 107 | .in -0.3i |
| 108 | .ft R |
| 109 | .PP |
| 110 | |
| 111 | \&\fR |
| 112 | .PP |
| 113 | Each of the following starts a floppy daemon giving access to |
| 114 | \&\fR\&\f(CW\(if/dev/fd1\(is\fR, tied to the :1 local X servers, and listening on port |
| 115 | 5704. We assume that the local host is named \fR\&\f(CWhitchhiker\fR. |
| 116 | .PP |
| 117 | |
| 118 | .nf |
| 119 | .ft 3 |
| 120 | .in +0.3i |
| 121 | floppyd -d /dev/fd0 |
| 122 | floppyd -d -x :1 -p 5704 /dev/fd0 |
| 123 | .fi |
| 124 | .in -0.3i |
| 125 | .ft R |
| 126 | .PP |
| 127 | |
| 128 | \&\fR |
| 129 | .PP |
| 130 | If you want to start floppyd by \fR\&\f(CWinetd\fR instead of running it as a |
| 131 | daemon, insert the following lines into \fR\&\f(CW\(if/etc/services\(is\fR: |
| 132 | |
| 133 | .nf |
| 134 | .ft 3 |
| 135 | .in +0.3i |
| 136 | # floppy daemon |
| 137 | floppyd-0 5703/tcp # floppy daemon for X server :0 |
| 138 | floppyd-1 5704/tcp # floppy daemon for X server :1 |
| 139 | .fi |
| 140 | .in -0.3i |
| 141 | .ft R |
| 142 | .PP |
| 143 | |
| 144 | \&\fR |
| 145 | .PP |
| 146 | And insert the following into \fR\&\f(CW\(if/etc/inetd.conf\(is\fR (assuming that you |
| 147 | have defined a user named floppy in your \fR\&\f(CW\(if/etc/passwd\(is\fR): |
| 148 | .PP |
| 149 | |
| 150 | .nf |
| 151 | .ft 3 |
| 152 | .in +0.3i |
| 153 | # floppy daemon |
| 154 | floppyd-0 stream tcp wait floppy /usr/sbin/floppyd floppyd /dev/fd0 |
| 155 | floppyd-1 stream tcp wait floppy /usr/sbin/floppyd floppyd -x :1 /dev/fd0 |
| 156 | .fi |
| 157 | .in -0.3i |
| 158 | .ft R |
| 159 | .PP |
| 160 | |
| 161 | \&\fR |
| 162 | .PP |
| 163 | Note that you need to supply the X display names for the second |
| 164 | floppyd. This is because the port is opened by inetd.conf, and hence |
| 165 | floppyd cannot know its number to interfere the display number. |
| 166 | .PP |
| 167 | On the client side, insert the following into your \fR\&\f(CW\(if~/.mtoolsrc\(is\fR |
| 168 | to define a drive letter accessing floppy drive in your X terminal: |
| 169 | |
| 170 | .nf |
| 171 | .ft 3 |
| 172 | .in +0.3i |
| 173 | drive x: file="$DISPLAY" remote |
| 174 | .fi |
| 175 | .in -0.3i |
| 176 | .ft R |
| 177 | .PP |
| 178 | |
| 179 | \&\fR |
| 180 | .PP |
| 181 | If your X terminal has more than one drive, you may access the |
| 182 | additional drives as follows: |
| 183 | |
| 184 | .nf |
| 185 | .ft 3 |
| 186 | .in +0.3i |
| 187 | drive y: file="$DISPLAY//1" remote |
| 188 | drive z: file="$DISPLAY//2" remote |
| 189 | .fi |
| 190 | .in -0.3i |
| 191 | .ft R |
| 192 | .PP |
| 193 | |
| 194 | \&\fR |
| 195 | .PP |
| 196 | .SH See\ Also |
| 197 | Mtools' texinfo doc |
| 198 | .SH Viewing\ the\ texi\ doc |
| 199 | This manpage has been automatically generated from mtools's texinfo |
| 200 | documentation. However, this process is only approximative, and some |
| 201 | items, such as crossreferences, footnotes and indices are lost in this |
| 202 | translation process. Indeed, these items have no appropriate |
| 203 | representation in the manpage format. Moreover, not all information has |
| 204 | been translated into the manpage version. Thus I strongly advise you to |
| 205 | use the original texinfo doc. See the end of this manpage for |
| 206 | instructions how to view the texinfo doc. |
| 207 | .TP |
| 208 | * \ \ |
| 209 | To generate a printable copy from the texinfo doc, run the following |
| 210 | commands: |
| 211 | |
| 212 | .nf |
| 213 | .ft 3 |
| 214 | .in +0.3i |
| 215 | ./configure; make dvi; dvips mtools.dvi |
| 216 | .fi |
| 217 | .in -0.3i |
| 218 | .ft R |
| 219 | .PP |
| 220 | |
| 221 | \&\fR |
| 222 | .TP |
| 223 | * \ \ |
| 224 | To generate a html copy, run: |
| 225 | |
| 226 | .nf |
| 227 | .ft 3 |
| 228 | .in +0.3i |
| 229 | ./configure; make html |
| 230 | .fi |
| 231 | .in -0.3i |
| 232 | .ft R |
| 233 | .PP |
| 234 | |
| 235 | \&\fRA premade html can be found at |
| 236 | \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR |
| 237 | .TP |
| 238 | * \ \ |
| 239 | To generate an info copy (browsable using emacs' info mode), run: |
| 240 | |
| 241 | .nf |
| 242 | .ft 3 |
| 243 | .in +0.3i |
| 244 | ./configure; make info |
| 245 | .fi |
| 246 | .in -0.3i |
| 247 | .ft R |
| 248 | .PP |
| 249 | |
| 250 | \&\fR |
| 251 | .PP |
| 252 | The texinfo doc looks most pretty when printed or as html. Indeed, in |
| 253 | the info version certain examples are difficult to read due to the |
| 254 | quoting conventions used in info. |
| 255 | .PP |