summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--sjauth/sjauth.132
-rw-r--r--sjauth/sjauth.c4
2 files changed, 36 insertions, 0 deletions
diff --git a/sjauth/sjauth.1 b/sjauth/sjauth.1
new file mode 100644
index 0000000..709a078
--- /dev/null
+++ b/sjauth/sjauth.1
@@ -0,0 +1,32 @@
+.Dd August 10, 2024
+.Dt SJAUTH 1
+.Os "YK Pao School Utilities"
+.
+.Sh NAME
+.Nm sjauth
+.Nd authenticate to YK Pao School's STUWIRELESS captive portal
+.
+.Sh SYNOPSIS
+.Nm
+.Ar username
+.Ar passvar
+.
+.Sh DESCRIPTION
+The
+.Nm
+script makes a single HTTP request to YK Pao School's STUWIRELESS captive portal
+to authenticate users.
+.Pp
+The arguments are as follows:
+.Bl -tag -width Ds
+.It Ar username
+Your YK Pao School username (such as s65535)
+.It Ar passvar
+The name of an environment variable containing your password
+.El
+.Sh AUTHORS
+.An Runxi Yu Aq Mt me@runxiyu.org
+.
+.Sh BUGS
+Send mail to
+.Aq Mt ~runxiyu/public-inbox@list.sr.ht
diff --git a/sjauth/sjauth.c b/sjauth/sjauth.c
index 989a587..126af6d 100644
--- a/sjauth/sjauth.c
+++ b/sjauth/sjauth.c
@@ -3,6 +3,10 @@
*
* Copyright (c) 2024 Runxi Yu <https://runxiyu.org>
* SPDX-License-Identifier: BSD-2-Clause
+ *
+ * BUG: We're using fixed-size buffers. They should be far larger than necessary
+ * for network authentication, but in case you have any issues with segmentation
+ * faults, increase the buffer size.
*/
#include <stdio.h>