---
name: "minieap"
section: "1"
platform: "linux"
package: "minieap"
version: "0.93-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/minieap"
---

# minieap(1)

Extensible 802.1x client with Ruijie v3/v4 support

## 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\]

## SEE ALSO

https://github.com/updateing/minieap

## 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).