Move mactelnetd man page to section 8 for admin commands

Author: haakonnessjoen

doc/Makefile.am

@@ -1,11 +1,11 @@
 dist_man_MANS = mactelnet.1 mndp.1 macping.1
 
 if BUILD_MACTELNETD
-dist_man_MANS += mactelnetd.1
-EXTRA_DIST = mactelnetd.1.in
-CLEANFILES = mactelnetd.1
+dist_man_MANS += mactelnetd.8
+EXTRA_DIST = mactelnetd.8.in
+CLEANFILES = mactelnetd.8
 
-mactelnetd.1: mactelnetd.1.in
-	$(AM_V_GEN)$(SED) -e 's|@sysconfdir[@]|$(sysconfdir)|g' mactelnetd.1.in > $@
+mactelnetd.8: mactelnetd.8.in
+	$(AM_V_GEN)$(SED) -e 's|@sysconfdir[@]|$(sysconfdir)|g' mactelnetd.8.in > $@
 
-endif
+endif

doc/mactelnetd.8

@@ -0,0 +1,60 @@
+.TH MACTELNETD 1 "February 27, 2011"
+.SH NAME
+mactelnetd \- Telnet daemon for MAC-address connections
+.SH SYNOPSIS
+.B mactelnetd
+.RI [ options ]
+.SH DESCRIPTION
+This daemon listens for telnet connections from Mikrotik RouterOS devices or mactelnet clients
+on the same physical network. It also announces it's hostname via the MNDP protocol every minute.
+.SH OPTIONS
+These programs follow the usual GNU command line syntax.
+A summary of options is included below.
+.TP
+.B \-n
+Do not use broadcast packets. A tad less insecure.
+This means that ethernet packets will have the mac-address of the client as the packet
+destination, instead of using the ethernet broadcast address.
+.TP
+.B \-o
+Use the older MD5 based authentication. This is less secure, and also requires your userfile to have the passwords in plaintext format. If you are running the server with this parameter, you cannot add users using the
+.B \-a
+option.
+.TP
+.B \-a
+Add a new user. The user should be an existing user in your system. This can be done without restarting your mactelnetd server as it re-reads the user file for each authentication attempt. You will be prompted for the username and password, or you can use one of the following options to specify them on the command line:
+.RS
+.TP
+.B \-u \fIusername\fR
+You can specify the new username to add on the command line using this option. If this is not used, you will be prompted for the username.
+.TP
+.B \-p \fIpassword\fR
+You can specify the new password for the new user to add on the command line using this option. If this is not used, you will be prompted for the password.
+.RE
+.TP
+.B \-d \fIusername\fR
+Delete the specified user.
+.TP
+.B \-l
+List the available users in the \fI/usr/local/etc/mactelnetd.users\fR file.
+.TP
+.B \-h
+Show summary of options.
+.TP
+.B \-v
+Show version of program.
+.SH FILES
+.TP
+.B /usr/local/etc/mactelnetd.users
+This file contains a line separated list of users that will have
+access to your machine. Usernames and passwords are separated
+by colon. This file is read each time a user connects.
+.SH SEE ALSO
+.BR mndp (1),
+.BR mactelnet (1),
+.BR macping (1).
+.SH AUTHOR
+mactelnetd was written by Håkon Nessjøen <haakon.nessjoen@gmail.com>.
+.PP
+This manual page was written by Håkon Nessjøen <haakon.nessjoen@gmail.com>,
+for the Debian project (and may be used by others).