From: Alan T. DeKok Date: Sun, 1 Feb 2026 21:47:41 +0000 (-0500) Subject: move directory and links X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2a44f2e5b1cc0e9f5fc1b0d88b42d64276aebb42;p=thirdparty%2Ffreeradius-server.git move directory and links --- diff --git a/doc/antora/modules/troubleshooting/nav.adoc b/doc/antora/modules/troubleshooting/nav.adoc index d7eff986566..0c4a38bdb37 100644 --- a/doc/antora/modules/troubleshooting/nav.adoc +++ b/doc/antora/modules/troubleshooting/nav.adoc @@ -1,28 +1,30 @@ * xref:index.adoc[Troubleshooting] -** xref:errors/index.adoc[Common Errors] -*** xref:errors/unknown_packet_code.adoc[Unknown packet code] -*** xref:errors/unexpected_request_code.adoc[Unexpected request code] -*** xref:errors/message_authenticator_missing.adoc[Message-Authenticator is missing] -*** xref:errors/message_authenticator_invalid.adoc[Message-Authenticator fail verification] -*** xref:errors/proxy_state_missing.adoc[Proxy-State is missing] -*** xref:errors/packet_fails_verification.adoc[Packet fails verification] -*** xref:errors/no_matching_request.adoc[Did not find request which matched response] +** xref:network/index.adoc[Network Errors] -** Less common errors -*** xref:errors/unexpected_response_code.adoc[Unexpected response code] -*** xref:errors/too_many_attributes.adoc[Packet contains too many attributes] -*** xref:errors/io_error.adoc[IO error] +*** Common Errors +**** xref:network/unknown_packet_code.adoc[Unknown packet code] +**** xref:network/unexpected_request_code.adoc[Unexpected request code] +**** xref:network/message_authenticator_missing.adoc[Message-Authenticator is missing] +**** xref:network/message_authenticator_invalid.adoc[Message-Authenticator fail verification] +**** xref:network/proxy_state_missing.adoc[Proxy-State is missing] +**** xref:network/packet_fails_verification.adoc[Packet fails verification] +**** xref:network/no_matching_request.adoc[Did not find request which matched response] -** Rare errors -*** xref:errors/packet_too_small.adoc[Packet is too small] -*** xref:errors/packet_too_large.adoc[Packet is too large] -*** xref:errors/mismatched_length.adoc[Header length does not match received packet length] -*** xref:errors/attribute_0.adoc[Attribute 0 is invalid] -*** xref:errors/attribute_invalid_length.adoc[Attribute has invalid length] -*** xref:errors/attribute_overflow.adoc[Attribute overflows the packet] -*** xref:errors/decode_failure.adoc[Failure decoding a packet] -*** xref:errors/message_authenticator_length.adoc[Message Authenticator has invalid length] +*** Other Errors +**** xref:network/unexpected_response_code.adoc[Unexpected response code] +**** xref:network/too_many_attributes.adoc[Packet contains too many attributes] +**** xref:network/io_error.adoc[IO error] + +*** Rare Errors +**** xref:network/packet_too_small.adoc[Packet is too small] +**** xref:network/packet_too_large.adoc[Packet is too large] +**** xref:network/mismatched_length.adoc[Header length does not match received packet length] +**** xref:network/attribute_0.adoc[Attribute 0 is invalid] +**** xref:network/attribute_invalid_length.adoc[Attribute has invalid length] +**** xref:network/attribute_overflow.adoc[Attribute overflows the packet] +**** xref:network/decode_failure.adoc[Failure decoding a packet] +**** xref:network/message_authenticator_length.adoc[Message Authenticator has invalid length] ** xref:user.adoc[User Management] diff --git a/doc/antora/modules/troubleshooting/pages/errors/index.adoc b/doc/antora/modules/troubleshooting/pages/errors/index.adoc deleted file mode 100644 index 24f24a11e0c..00000000000 --- a/doc/antora/modules/troubleshooting/pages/errors/index.adoc +++ /dev/null @@ -1,33 +0,0 @@ -= Errors - -== Server isn't receiving packets - -* Common errors -** xref:errors/unknown_packet_code.adoc[Unknown packet code] -** xref:errors/unexpected_request_code.adoc[Unexpected request code] -** xref:errors/message_authenticator_missing.adoc[Message-Authenticator is missing] -** xref:errors/message_authenticator_invalid.adoc[Message-Authenticator fail verification] -** xref:errors/proxy_state_missing.adoc[Proxy-State is missing] -** xref:errors/packet_fails_verification.adoc[Packet fails verification] -** xref:errors/no_matching_request.adoc[Did not find request which matched response] - -** Less common errors -** xref:errors/unexpected_response_code.adoc[Unexpected response code] -** xref:errors/too_many_attributes.adoc[Packet contains too many attributes] -** xref:errors/io_error.adoc[IO error] - -* Rare errors -** xref:errors/packet_too_small.adoc[Packet is too small] -** xref:errors/packet_too_large.adoc[Packet is too large] -** xref:errors/mismatched_length.adoc[Header length does not match received packet length] -** xref:errors/attribute_0.adoc[Attribute 0 is invalid] -** xref:errors/attribute_invalid_length.adoc[Attribute has invalid length] -** xref:errors/attribute_overflow.adoc[Attribute overflows the packet] -** xref:errors/decode_failure.adoc[Failure decoding a packet] -** xref:errors/message_authenticator_length.adoc[Message Authenticator has invalid length] - -== Authentication Failures - -== Issues with Databases -// Copyright (C) 2026 Network RADIUS SAS. Licenced under CC-by-NC 4.0. -// This documentation was developed by Network RADIUS SAS. diff --git a/doc/antora/modules/troubleshooting/pages/index.adoc b/doc/antora/modules/troubleshooting/pages/index.adoc index c1e7e8609ca..73bce33857d 100644 --- a/doc/antora/modules/troubleshooting/pages/index.adoc +++ b/doc/antora/modules/troubleshooting/pages/index.adoc @@ -28,11 +28,12 @@ output. Don't look at the output of `radclient. You cannot debug server policies by looking at a simple binary `Access-Accept` or `Access-Reject` on the client. -== Common Errors +== Network Errors -The xref:errors/index.adoc[common errors] page covers the most common -errors that people see when trying to configure the server. If you -see an error which is unclear to you, you should start on that page. +The xref:network/index.adoc[network errors] page covers the most +common errors that people see when initially trying to configure the +server. If you see an error which is unclear to you, you should start +on that page. The error messages produced by FreeRADIUS are necessrily short, and cannot contain a full explanation of the issue. The documentation diff --git a/doc/antora/modules/troubleshooting/pages/errors/attribute_0.adoc b/doc/antora/modules/troubleshooting/pages/network/attribute_0.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/attribute_0.adoc rename to doc/antora/modules/troubleshooting/pages/network/attribute_0.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/attribute_invalid_length.adoc b/doc/antora/modules/troubleshooting/pages/network/attribute_invalid_length.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/attribute_invalid_length.adoc rename to doc/antora/modules/troubleshooting/pages/network/attribute_invalid_length.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/attribute_overflow.adoc b/doc/antora/modules/troubleshooting/pages/network/attribute_overflow.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/attribute_overflow.adoc rename to doc/antora/modules/troubleshooting/pages/network/attribute_overflow.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/decode_failure.adoc b/doc/antora/modules/troubleshooting/pages/network/decode_failure.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/decode_failure.adoc rename to doc/antora/modules/troubleshooting/pages/network/decode_failure.adoc diff --git a/doc/antora/modules/troubleshooting/pages/network/index.adoc b/doc/antora/modules/troubleshooting/pages/network/index.adoc new file mode 100644 index 00000000000..45f47ef9a50 --- /dev/null +++ b/doc/antora/modules/troubleshooting/pages/network/index.adoc @@ -0,0 +1,36 @@ += Errors + +== The Server isn't receiving packets + +These are _network_ errors. + +* Common errors +** xref:network/unknown_packet_code.adoc[Unknown packet code] +** xref:network/unexpected_request_code.adoc[Unexpected request code] +** xref:network/message_authenticator_missing.adoc[Message-Authenticator is missing] +** xref:network/message_authenticator_invalid.adoc[Message-Authenticator fail verification] +** xref:network/proxy_state_missing.adoc[Proxy-State is missing] +** xref:network/packet_fails_verification.adoc[Packet fails verification] +** xref:network/no_matching_request.adoc[Did not find request which matched response] + +** Other errors +** xref:network/unexpected_response_code.adoc[Unexpected response code] +** xref:network/too_many_attributes.adoc[Packet contains too many attributes] +** xref:network/io_error.adoc[IO error] + +* Rare errors +** xref:network/packet_too_small.adoc[Packet is too small] +** xref:network/packet_too_large.adoc[Packet is too large] +** xref:network/mismatched_length.adoc[Header length does not match received packet length] +** xref:network/attribute_0.adoc[Attribute 0 is invalid] +** xref:network/attribute_invalid_length.adoc[Attribute has invalid length] +** xref:network/attribute_overflow.adoc[Attribute overflows the packet] +** xref:network/decode_failure.adoc[Failure decoding a packet] +** xref:network/message_authenticator_length.adoc[Message Authenticator has invalid length] + +== Authentication Failures + +== Issues with Databases + +// Copyright (C) 2026 Network RADIUS SAS. Licenced under CC-by-NC 4.0. +// This documentation was developed by Network RADIUS SAS. diff --git a/doc/antora/modules/troubleshooting/pages/errors/io_error.adoc b/doc/antora/modules/troubleshooting/pages/network/io_error.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/io_error.adoc rename to doc/antora/modules/troubleshooting/pages/network/io_error.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/message_authenticator_invalid.adoc b/doc/antora/modules/troubleshooting/pages/network/message_authenticator_invalid.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/message_authenticator_invalid.adoc rename to doc/antora/modules/troubleshooting/pages/network/message_authenticator_invalid.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/message_authenticator_length.adoc b/doc/antora/modules/troubleshooting/pages/network/message_authenticator_length.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/message_authenticator_length.adoc rename to doc/antora/modules/troubleshooting/pages/network/message_authenticator_length.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/message_authenticator_missing.adoc b/doc/antora/modules/troubleshooting/pages/network/message_authenticator_missing.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/message_authenticator_missing.adoc rename to doc/antora/modules/troubleshooting/pages/network/message_authenticator_missing.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/mismatched_length.adoc b/doc/antora/modules/troubleshooting/pages/network/mismatched_length.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/mismatched_length.adoc rename to doc/antora/modules/troubleshooting/pages/network/mismatched_length.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/no_matching_request.adoc b/doc/antora/modules/troubleshooting/pages/network/no_matching_request.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/no_matching_request.adoc rename to doc/antora/modules/troubleshooting/pages/network/no_matching_request.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/packet_fails_verification.adoc b/doc/antora/modules/troubleshooting/pages/network/packet_fails_verification.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/packet_fails_verification.adoc rename to doc/antora/modules/troubleshooting/pages/network/packet_fails_verification.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/packet_too_large.adoc b/doc/antora/modules/troubleshooting/pages/network/packet_too_large.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/packet_too_large.adoc rename to doc/antora/modules/troubleshooting/pages/network/packet_too_large.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/packet_too_small.adoc b/doc/antora/modules/troubleshooting/pages/network/packet_too_small.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/packet_too_small.adoc rename to doc/antora/modules/troubleshooting/pages/network/packet_too_small.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/proxy_state_missing.adoc b/doc/antora/modules/troubleshooting/pages/network/proxy_state_missing.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/proxy_state_missing.adoc rename to doc/antora/modules/troubleshooting/pages/network/proxy_state_missing.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/too_many_attributes.adoc b/doc/antora/modules/troubleshooting/pages/network/too_many_attributes.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/too_many_attributes.adoc rename to doc/antora/modules/troubleshooting/pages/network/too_many_attributes.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/unexpected_request_code.adoc b/doc/antora/modules/troubleshooting/pages/network/unexpected_request_code.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/unexpected_request_code.adoc rename to doc/antora/modules/troubleshooting/pages/network/unexpected_request_code.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/unexpected_response_code.adoc b/doc/antora/modules/troubleshooting/pages/network/unexpected_response_code.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/unexpected_response_code.adoc rename to doc/antora/modules/troubleshooting/pages/network/unexpected_response_code.adoc diff --git a/doc/antora/modules/troubleshooting/pages/errors/unknown_packet_code.adoc b/doc/antora/modules/troubleshooting/pages/network/unknown_packet_code.adoc similarity index 100% rename from doc/antora/modules/troubleshooting/pages/errors/unknown_packet_code.adoc rename to doc/antora/modules/troubleshooting/pages/network/unknown_packet_code.adoc