SHOREWALL6-LITE.C(5)

πŸ“¦
version 5.2.8 Β· 2 versions
  • 5.2.8 Β· debian bookworm, debian trixie, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 5.2.3.4 Β· ubuntu jammy
, in debian bookworm, debian trixie, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– SHOREWALL6-LITE.C(5) β€” the shorewall6-lite.conf glow-up πŸ’–

okay bestie, so this is the manual page for shorewall6-lite.conf, from the Configuration Files section of the manual. yes it's giving "boring system file" but lowkey it's the main character of your whole IPv6 firewall setup, so let's get into it 🫢


✨ NAME ✨

shorewall6-lite.conf β€” the Shorewall6 Lite global configuration file. it's the one file that sets the vibe for everything 🌸


✨ SYNOPSIS ✨

/etc/shorewall6-lite/shorewall6-lite.conf

that's it. that's the path. she lives there πŸ’…


✨ DESCRIPTION ✨

This file sets options that apply to Shorewall6 Lite as a whole. like, the whole entire thing. global queen energy πŸ‘‘

The file consists of Shell comments (lines beginning with #), blank lines and assignment statements (variable=value). Each variable's setting is preceded by comments that describe the variable and it's effect. so like, the comments are literally right there telling you what's up β€” read them, bestie, they're free ✨

Any option not specified in this file gets its value from the shorewall6.conf file used during compilation of /var/lib/shorewall6-lite/firewall. Those settings may be found in the file /var/lib/shorewall6-lite/firewall.conf. so if you're like "wait why is this doing that" β€” that's where the default came from, no cap πŸ”


✨ OPTIONS ✨

The following options may be set in shorewall6.conf.

  • IP6TABLES=[pathname] β€” This parameter names the ip6tables executable to be used by Shorewall6. If not specified or if specified as a null value, then the ip6tables executable located using the PATH option is used. so like, tell her which ip6tables to use, or she'll go find one herself 🧚
  • LOGFILE=[pathname] β€” This parameter tells the /sbin/shorewall6 program where to look for Shorewall6 messages when processing the dump, logwatch, show log, and hits commands. If not assigned or if assigned an empty value, /var/log/messages is assumed. default is that classic /var/log/messages, periodt πŸ“œ
  • LOGFORMAT=["formattemplate"] β€” The value of this variable generate the --log-prefix setting for Shorewall6 logging rules. It contains a β€œprintf” formatting template which accepts three arguments (the chain name, logging rule number (optional) and the disposition). To use LOGFORMAT with fireparse, set it as:
LOGFORMAT="fp=%s:%d a=%s "

If the LOGFORMAT value contains the substring β€œ%d” then the logging rule number is calculated and formatted in that position; if that substring is not included then the rule number is not included. If not supplied or supplied as empty (LOGFORMAT="") then β€œShorewall6:%s:%s:” is assumed. so %d is the glow-up switch for "do we show the rule number or not" πŸ”₯

  • PATH=pathname[:pathname]... β€” Determines the order in which Shorewall6 searches directories for executable files. it's the search order, she's picky about it πŸŽ€
  • RESTOREFILE=[filename] β€” Specifies the simple name of a file in /var/lib/shorewall6 to be used as the default restore script in the shorewall6 save, shorewall6 restore, shorewall6 forget and shorewall6 -f start commands. simple name only, bestie β€” she knows where to look πŸ’œ
  • SHOREWALL_SHELL=[pathname] β€” This option is used to specify the shell program to be used to interpret the compiled script. If not specified or specified as a null value, /bin/sh is assumed. Using a light-weight shell such as ash or dash can significantly improve performance. this is the "swap your shell, get free speed" hack and we are obsessed πŸƒβ™€οΈπŸ’¨
  • SUBSYSLOCK=[pathname] β€” This parameter should be set to the name of a file that the firewall should create if it starts successfully and remove when it stops. Creating and removing this file allows Shorewall6 to work with your distribution's initscripts. For RedHat, this should be set to /var/lock/subsys/shorewall6. For Debian, the value is /var/state/shorewall6 and in LEAF it is /var/run/shorewall. this is the "hey initscripts, she's alive" flag 🚩
  • VERBOSITY=[number] β€” Shorewall6 has traditionally been very noisy (produced lots of output). You may set the default level of verbosity using the VERBOSITY OPTION. like, she used to talk A LOT. you can turn that down 😭

Values are:

  • 0 β€” Silent. You may make it more verbose using the -v option
  • 1 β€” Major progress messages displayed
  • 2 β€” All progress messages displayed (old default behavior)

If not specified, then 2 is assumed. so yeah, by default she's yapping, fr fr πŸ—£οΈ


✨ FILES ✨

  • /etc/shorewall6-lite/shorewall6.conf

✨ SEE ALSO ✨

that's the whole reading list, bestie β€” go collect them all like they're limited edition 🌈⭐


and that's the page!! this one lives in the Configuration Files manual section, from version 09/24/2020, filed under the name SHOREWALL6-LITE.C(5). love her, read her, configure responsibly πŸ’–πŸ’…πŸŒΈ