From d57da575efbaa47615a615f138e9a0d2f6e9233c Mon Sep 17 00:00:00 2001
From: Gary Guo <gary@garyguo.net>
Date: Sat, 14 Dec 2024 15:58:09 +0000
Subject: [PATCH] nixos-firewall-tool: add man page

---
 .../nixos-firewall-tool/nixos-firewall-tool.1   | 17 +++++++++++++++++
 pkgs/by-name/ni/nixos-firewall-tool/package.nix |  1 +
 2 files changed, 18 insertions(+)
 create mode 100644 pkgs/by-name/ni/nixos-firewall-tool/nixos-firewall-tool.1

diff --git a/pkgs/by-name/ni/nixos-firewall-tool/nixos-firewall-tool.1 b/pkgs/by-name/ni/nixos-firewall-tool/nixos-firewall-tool.1
new file mode 100644
index 000000000000..600c3f1e58ea
--- /dev/null
+++ b/pkgs/by-name/ni/nixos-firewall-tool/nixos-firewall-tool.1
@@ -0,0 +1,17 @@
+.TH nixos-firewall-tool 1
+.SH NAME
+nixos-firewall-tool \- a tool to temporarily manipulate the NixOS firewall
+.SH SYNOPSIS
+nixos-firewall-tool \fIsubcommand\fR
+
+Open TCP port:
+  nixos-firewall-tool open tcp 8888
+
+Open UDP port:
+  nixos-firewall-tool open udp 51820
+
+Show all firewall rules:
+  nixos-firewall-tool show
+
+Reset firewall configuration to system settings:
+  nixos-firewall-tool reset
diff --git a/pkgs/by-name/ni/nixos-firewall-tool/package.nix b/pkgs/by-name/ni/nixos-firewall-tool/package.nix
index 6e9f931403fd..73b32608e89a 100644
--- a/pkgs/by-name/ni/nixos-firewall-tool/package.nix
+++ b/pkgs/by-name/ni/nixos-firewall-tool/package.nix
@@ -24,6 +24,7 @@ stdenvNoCC.mkDerivation rec {
 
   installPhase = ''
     installBin nixos-firewall-tool
+    installManPage nixos-firewall-tool.1
     installShellCompletion nixos-firewall-tool.{bash,fish}
   '';