From: tharkadharshana Date: Thu, 15 Jan 2026 03:26:09 +0000 (+0530) Subject: doc: add logging instructions and specific error message examples X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=50e97a3d3769ec1df5da26a025a8eb97bb5a24f8;p=thirdparty%2Ffreeradius-server.git doc: add logging instructions and specific error message examples --- diff --git a/doc/antora/modules/tutorials/pages/new_user.adoc b/doc/antora/modules/tutorials/pages/new_user.adoc index 878b4fc5391..3cda460e74d 100644 --- a/doc/antora/modules/tutorials/pages/new_user.adoc +++ b/doc/antora/modules/tutorials/pages/new_user.adoc @@ -79,14 +79,32 @@ $ radiusd -X ---------------- Send the test packet again, and after the Access-Reject is received by -the client, "exit" the shell to close the "log.txt" file. Open the -"log.txt" file in a text editor, and read the output. The cause of the +the client, "exit" the shell to close the "log.txt" file. +[source, bash] +---------------- +exit +---------------- +Open the "log.txt" file in a text editor, and read the output. The cause of the error can generally be determined from those messages. -The error will usually be one of the following problems: +The error will usually be one of a few common problems. The following +list contains a short description of each common error, and an example +of the debug output with the relevant messages: + +* the shared secret was incorrect, in case you will see a message similar to the follow +[source, text] +---- +(0) ERROR: Failed decoding packet: invalid Message-Authenticator (shared secret is incorrect) +---- -* the shared secret was incorrect * the user was not found, or no entry matched the request. +[source, text] +---- +(0) authenticate pap { +(0) pap - Login attempt with password +(0) pap - ERROR: No "known good" password found for user +(0) pap (fail) +---- Test the server again with a PAP password, but this time, deliberately use the wrong shared secret. Observe what happens and what error