From a91a271f4ebba2415e96008ef5c6204984d8336e Mon Sep 17 00:00:00 2001 From: David Lamparter Date: Sat, 15 Jul 2023 08:36:14 -0700 Subject: [PATCH] debian: clean up outdated/useless READMEs Signed-off-by: David Lamparter --- debian/README.Debian | 65 +++++++--------------------------------- debian/README.Maintainer | 32 -------------------- debian/changelog | 1 + 3 files changed, 12 insertions(+), 86 deletions(-) delete mode 100644 debian/README.Maintainer diff --git a/debian/README.Debian b/debian/README.Debian index 53fb6c9d0e..1d61ca9f05 100644 --- a/debian/README.Debian +++ b/debian/README.Debian @@ -1,5 +1,5 @@ -* SAFETY MEASURES: -================== +SAFETY MEASURES +=============== Please consider setting this package "on hold" by typing echo "frr hold" | dpkg --set-selections @@ -11,19 +11,19 @@ Instead apt-get only displays a warning saying that a new version would be available forcing you to explicitly type "apt-get install frr" to upgrade it. -* What is frr? -================= +What is frr? +============ http://www.frrouting.org/ FRR is a routing software suite, providing implementations of OSPFv2, OSPFv3, RIP v1 and v2, RIPng, ISIS, PIM, BGP and LDP for Unix platforms, particularly FreeBSD and Linux and also NetBSD, to mention a few. FRR is a fork of Quagga -which itself is a fork of Zebra. +which itself is a fork of Zebra. Zebra was developed by Kunihiro Ishiguro. -* Build Profiles used in the upstream debian/ -============================================= +Build Profiles used in the upstream debian/ +=========================================== The following Build Profiles have been added: @@ -40,8 +40,8 @@ The main frr package has the exact same contents regardless of rtrlib or snmp choices. The options only control frr-snmp and frr-rpki-rtrlib packages. -* Debian Policy compliance notes -================================ +Debian Policy compliance notes +============================== - 4.15 Reproducibility FRR build is reproducible as outlined in version 4.2.1 of the Policy, but @@ -50,51 +50,8 @@ choices. The options only control frr-snmp and frr-rpki-rtrlib packages. like -fdebug-prefix-map=/build/directory/... -* Daemon selection: -=================== - -The Debian package uses /etc/frr/daemons to tell the -initscript which daemons to start. It's in the format -= -with no spaces (it's simply source-d into the initscript). -Default is not to start anything, since it can hose your -system's routing table if not set up properly. - -Priorities were suggested by Dancer . -They're used to start the FRR daemons in more than one step -(for example start one or two at network initialization and the -rest later). The number of FRR daemons being small, priorities -must be between 1 and 9, inclusive (or the initscript has to be -changed). /etc/init.d/frr then can be started as - -/etc/init.d/frr > - -where priority 0 is the same as 'stop', priority 10 or 'start' -means 'start all' - - -* Error message "privs_init: initial cap_set_proc failed": -========================================================== - -This error message means that "capability support" has to be built -into the kernel. - - -* Error message "netlink-listen: overrun: No buffer space available": -===================================================================== - -If this message occurs the receive buffer should be increased by adding the -following to /etc/sysctl.conf and "--nl-bufsize" to /etc/frr/daemons. -> net.core.rmem_default = 262144 -> net.core.rmem_max = 262144 -See message #4525 from 2005-05-09 in the quagga-users mailing list. - - -* vtysh immediately exists: -=========================== +vtysh immediately exists +======================== Check /etc/pam.d/frr, it probably denies access to your user. The passwords configured in /etc/frr/frr.conf are only for telnet access. - - - -- Ondřej Surý >, Fri, 3 Jul 2020 12:39:42 +0200 diff --git a/debian/README.Maintainer b/debian/README.Maintainer deleted file mode 100644 index 9030022c5e..0000000000 --- a/debian/README.Maintainer +++ /dev/null @@ -1,32 +0,0 @@ -# -# TODO -# - -- check that tests/{control,daemons} actually do something useful and sensible -- /usr/share/doc/frr-doc should be named just frr? -- debian/watch pgpsigurlmangle / signing-key -- multiarch for DSOs? -- frr try-restart - -# -# To check if the patches still apply on new upstream versions: -# -for i in debian/patches/*.diff; do echo -e "#\n# $i\n#"; patch --fuzz=3 --dry-run -p1 < $i; done - -# -# Filename transition from zebra to frr -# - -Files that keep their names - /usr/bin/vtysh - -Files that got an -pj suffix - /etc/default/zebra -> /etc/frr/daemons.conf - /etc/init.d/zebra -> /etc/init.d/frr - /etc/zebra/ -> /etc/frr/ - /usr/share/doc/zebra/ -> /usr/share/doc/frr/ - /var/log/zebra/ -> /var/log/frr/ - /var/run/ -> /var/run/frr/ - -Files that were moved - /usr/sbin/* -> /usr/lib/frr/ diff --git a/debian/changelog b/debian/changelog index f69c482602..74e6778d39 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,6 +1,7 @@ frr (8.5.2-1) UNRELEASED; urgency=medium * new upstream release FRR 8.5.2 + * cleaned up outdated debian/README files -- David Lamparter Sat, 15 Jul 2023 08:33:59 -0700 -- 2.39.5