uruk-save(8)

πŸ“¦
this version Β· 3 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute

πŸ’Ύ uruk-save β€” the girlies' guide to uruk-save(8) πŸ’Ύ

okay so bestie, welcome to the SYSTEM ADMINISTRATION section of the manual, and today's main character is uruk-save. she's little, she's simple, she saves your uruk rc config in that classic iptables-save-style format. let's get into it 🫢


✨ NAME ✨

uruk-save β€” save uruk rc configuration in iptables-save-style format. that's it. that's the whole job. no cap πŸ’…


🌸 SYNOPSIS 🌸

uruk-save [-6]

πŸŽ€ OPTIONS πŸŽ€

  • -6 β€” bestie, do not save the iptables rules. instead save the ip6tables rules, for IPv6 filtering. it's giving "we're doing the v6 thing now" ✨

πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea β˜•: uruk-save saves the IPv4 rules β€” and yes, that's all of the filter, raw, mangle and nat tables β€” into /etc/uruk/rc, in iptables-save(5)-style format. and the iconic part? it does this without invoking iptables(8). we simply don't need him πŸ’…

if you pass the -6 option, then the IPv6 rules (if any, bestie β€” if any) in /etc/uruk/rc get saved instead, in ip6tables-save(5)-style format. slay.

it prints output to stdout, so the suggested invocation is literally:

# uruk-save > /var/lib/uruk/iptables/active

or

# uruk-save -6 > /var/lib/uruk/ip6tables/active

.

this script is useful if you don't like the default behaviour of the uruk init script, and you'd like it to load the current uruk rc file instead of the current active file. so valid. so real.

please note: generally you don't need to invoke this script manually β€” like, at all. the script urukctl, which comes with uruk, is suitable for most cases, and it invokes uruk-save if needed. let her cook πŸ‘‘

πŸ’€ WARNING πŸ’€

just as with uruk, in order to keep the uruk-save script small and simple, the script does very little error handling. it does not check the contents of the rc file in any way before executing it. when your rc file contains bogus stuff, uruk-save will very likely behave in unexpected ways. caveat emptor. 😭

things will likely break if you do very fancy stuff in an rc hook file. if your rc file is in verbose mode (i.e. it features set -x) or in no-act mode (i.e. it features a hardcoded iptables='echo iptables'), uruk-save fails. that's the vibe check and it did not pass πŸ™ˆ


🌈 SEE ALSO 🌈

uruk(8), uruk-rc(5) .


Copyright (C) 2005, 2007, 2010, 2011, 2012, 2013 Joost van Baal-Ilić <joostvb-uruk@mdcc.cx>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.


πŸ’œ AUTHOR πŸ’œ

Joost van Baal-Ilić <joostvb-uruk@mdcc.cx>


and that's the whole page, bestie!! 🧚 this was uruk-save version 20190121, dated 21 јан 2019, living her best life in section 8 of the manual. mwah πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ«ΆπŸ”₯πŸ‘‘πŸŒˆβ­πŸ’€πŸ™ˆπŸ“πŸ’œ

πŸ“¦ where this page comes from