minieap(1)

📦 version 0.93, in arch rolling

👑 NAME

minieap — the extensible 802.1x client that actually speaks Ruijie v3/v4, bestie 💅

✨ SYNOPSIS ✨

minieap [OPTIONS...]

🦋 DESCRIPTION 🦋

Okay so real talk: minieap is a supplicant for the modified 802.1x authentication methods out there — you know the ones, like Ruijie, that do their own little thing instead of playing by the standard's rules 🙈. It's the friend who shows up to the group project already knowing everyone's weird quirks. Iconic behavior, honestly.

🎀 OPTIONS 🎀

  • --help, -h — show help information. Your "hey what's good" button 🫶
  • --kill, -k [0|...] — kill other instances and exit. But listen: args other than 0 mean it kills the other instances and keeps running — so 0 = bye-bye, anything else = bye-bye to the others, not you 💀
  • --save, -w — save present config. Claude that vibe check before it's gone ✨
  • --username, -u <username> — username
  • --password, -p <username> — password (and yes, the page literally writes the placeholder as <username> — I'm not gonna lie to you about what it says 🍓)
  • --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> — how deep into the shadows you wanna go 🌈
    • 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] ⭐ (one and done, bestie)
  • --pkt-plugin <plugin> — active the corresponding package modifier. The option can be used more than once. [default is none] 💖 (this one you can stack, no cap)
  • --module <module> — active the corresponding module. The option can be used more than once.
⚠️ Important one, don't skip it: if you use --module or --pkt-plugin in the command line, all the lines in config file containing module= will be ignored. So it's giving "main character energy" — command line wins, periodt.

🌸 Available network modules 🌸

  • sockraw — a module use RAW Socket

🧚 Available package modifier 🧚

  • printer — print all the package that go through it. Free lil' spy cam for your packets, iykyk 🎀
  • 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 🌈

Go touch grass on the repo, it's right there 🦋

💖 AUTHOR 💖

The maintainer of minieap is updateing.

This manual page was written by GengYu Rao, for the Debian project (and may be used by others). Slay, Debian 🫶

Okay that's the whole thing bestie, no crumbs left — it's minieap(1) from the General Commands Manual, and that's the whole vibe check, you're so welcome 💅✨🎀

📦 where this page comes from