minieap(1) · carta

NAME

minieap - Extensible 802.1x client with Ruijie v3/v4 support

SYNOPSIS

minieap [OPTIONS...]

DESCRIPTION

minieap can be used as a supplicant for modified 802.1x authentication methods like Ruijie.

OPTIONS

--help, -h: show help information

--kill, -k [0|...]: kill other instances and exit. args other than 0 means to kill other instances and keeps running.

--save, -w: save present config

--username, -u <username>: username

--password, -p <username>: password

--nic, -n <interface>: network interface

--stage-timeout, -t <second>: timeout for each auth [default is 5]

--wait-after-fail, -r <second>: time to wait after fail (but will start immediately if the server ask to) [default is 30]

--max-fail, -l <num>: max failure times [default is 3]

--no-auto-reauth, -x: do not retry after disconnected [default is yes]

--daemonize, -b <0-3>: 0 = run foreground
1 = run as daemon, without output
2 = run as daemon, output to the console
3 = run as daemon, output to the log
[default is 0]

--proxy-lan-iface, -z <interface>: the LAN interface if auth via proxy [default is none]

--auth-round, -j <count>: times needs to auth [default is 1]

--max-retries <count>: max retry times [default is 3]

--pid-file <pidfile>: set to none to disable [default is /var/run/minieap.pid]

--conf-file <conffile>: config file [default /etc/minieap.conf]

--if-impl <module>: choose the network module. The option can be only used once. [default is the first available one]

--pkt-plugin <plugin>: active the corresponding package modifier. The option can be used more than once. [default is none]

--module <module>

active the corresponding module. The option can be used more than once.

If you use --module or --pkt-plugin in command line, all the lines in config file containing "module=" will be ignored.

Available network modules

sockraw: a module use RAW Socket

Available package modifier

printer: print all the package that go through it

rjv3

use auth algorithm via hyrathb@GitHub Ruijie V3

--heartbeat, -e <second>: seconds between packages [default is 60]

--eap-bcast-addr, -a <0-1>: Start package broadcast address [default BROADCAST_STANDARD] 0 = standard 1 = ruijie's address

--dhcp-type, -d <0-3>: DHCP methods [default HCP_AFTER_AUTH]
0 = don't use DHCP
1 = secondary auth
2 = post-auth DHCP
3 = pre-auth DHCP

--dhcp-script, -c <script>: run script between secondary auth and post-auth [default is none]

--rj-option <type>:<value>[:r]

customize sections, the type and value must be in hex.

For example, --rj-option 6a:000102 means add a section of type 0x6a, with the content of 0x00 0x01 0x02 .

:r means replace the default one generated by this program. For example, --rj-option 6f:000102:r means to replace the contents of 0x6f type to 0x00 0x12 0x02 .

If the command line and the config file all have this one, both config will work.

--service <service>: customize service name [default is internet]

--version-str <version>: customize version string [default is RG-SU For Linux V1.0]

--fake-dns1 <DNS>: customize main DNS address (IPv4 in Dotted Decimal Notation) [it will get a address by default]

--fake-dns2 <DNS>: customize secondary DNS address (IPv4/IPv6)

--fake-serial <serial>: customize hard disk serial [it will gain by default]

--max-dhcp-count <count>: the times of timeout allowed when second auth wait for DHCP [default is 3]

AUTHOR

The maintainer of minieap is updateing ⟨haotia@\:gmail.com⟩.

This manual page was written by GengYu Rao ⟨zouyoo@\:outlook.com⟩, for the Debian project (and may be used by others).