[9front] [PATCH] remove /srv file reference from sam(1) and adding auth* function information to 9p(2)

[9front] [PATCH] remove /srv file reference from sam(1) and adding auth* function information to 9p(2)

[Jacob Moody]

[-- Attachment #1: Type: text/plain, Size: 230 bytes --]

Hello,

I have two quick man page patches. The first removes the references to the now deleted
/srv command file used by sam from the man pages.
The other documents that auth* helper functions within lib9p in 9p(2)

Thanks,
moody

[-- Attachment #2.1: Type: text/plain, Size: 359 bytes --]

from postmaster@1ess:
The following attachment had content that we can't
prove to be harmless.  To avoid possible automatic
execution, we changed the content headers.
The original header was:

	Content-Type: text/x-patch; charset=UTF-8;
 name="samnosrvman.patch"
	Content-Transfer-Encoding: 7bit
	Content-Disposition: attachment;
 filename="samnosrvman.patch"

[-- Attachment #2.2: samnosrvman.patch.suspect --]
[-- Type: application/octet-stream, Size: 936 bytes --]

 From dc31d1c0ac4200541781655434f16899cbf31b67
From: Jacob Moody <moody@posixcafe.org>
Date: Sat, 12 Jun 2021 18:44:17 +0000
Subject: [PATCH] sam: remove refrence to /srv file in man page

---
diff c12e49ecbf4ae7933b13d592543c9f7c7dc03581 dc31d1c0ac4200541781655434f16899cbf31b67
--- a/sys/man/1/sam	Sat Jun 12 13:03:26 2021
+++ b/sys/man/1/sam	Sat Jun 12 13:44:17 2021
@@ -854,22 +854,13 @@
 listens to the
 .B edit
 plumb port.
-If plumbing is not active,
-on invocation
-.I sam
-creates a named pipe
-.BI /srv/sam. user
-which acts as an additional source of commands.  Characters written to
-the named pipe are treated as if they had been typed in the command window.
 .PP
 .I B
 is a shell command that sends the named
 .IR files
-to the edit port of the plumber.
-If plumbing is not available,
-it attempts to load 
-.IR files
-through the named pipe.
+to the
+.B edit
+port of the plumber.
 .SS Abnormal termination
 If
 .I sam


[-- Attachment #3.1: Type: text/plain, Size: 355 bytes --]

from postmaster@1ess:
The following attachment had content that we can't
prove to be harmless.  To avoid possible automatic
execution, we changed the content headers.
The original header was:

	Content-Type: text/x-patch; charset=UTF-8;
 name="lib9pauth.patch"
	Content-Transfer-Encoding: 7bit
	Content-Disposition: attachment;
 filename="lib9pauth.patch"

[-- Attachment #3.2: lib9pauth.patch.suspect --]
[-- Type: application/octet-stream, Size: 1552 bytes --]

 From fd39176c0d7472347b9b50f178b05ede21a56001
From: Jacob Moody <moody@posixcafe.org>
Date: Sat, 12 Jun 2021 23:12:41 +0000
Subject: [PATCH] lib9p: add auth* functions to man page

---
diff c12e49ecbf4ae7933b13d592543c9f7c7dc03581 fd39176c0d7472347b9b50f178b05ede21a56001
--- a/sys/man/2/9p	Sat Jun 12 13:03:26 2021
+++ b/sys/man/2/9p	Sat Jun 12 18:12:41 2021
@@ -14,7 +14,7 @@
 readstr,
 respond,
 responderror,
-srv
+srv,
 srvacquire,
 srvforker,
 srvrelease,
@@ -23,7 +23,11 @@
 threadpostsharesrv,
 threadpostsrv,
 threadsrv,
-threadsrvforker - 9P file service
+threadsrvforker,
+auth9p,
+authattach,
+authread,
+authwrite \- 9P file service
 .SH SYNOPSIS
 .ft L
 .nf
@@ -114,6 +118,15 @@
 .ft L
 extern int chatty9p;
 .fi
+.PP
+.nf
+.ft L
+.ta \w'\fLvoid* 'u
+void	auth9p(Req *r);
+int		authattach(Req *r);
+void	authread(Req *r);
+void	authwrite(Req *r);
+.fi
 .SH DESCRIPTION
 The function
 .I srv
@@ -813,6 +826,40 @@
 (see
 .IR exits (2)).
 .PD
+.PP
+.I Auth9p,
+.I authattach,
+.I authwrite,
+and
+.I authread
+are functions to assist in the creation of authenticated
+file servers.
+.I Auth9p
+sets
+.I afid
+to point to
+.B /mnt/factotum/rpc
+then calls
+.I respond.
+It can be used as the
+.I auth
+service function address.
+.I Authattach
+will return 0 if the session has properly
+authenticated or will return -1 and
+call
+.I respond
+with an apropiate error.
+.I Authread
+and
+.I authwrite
+can be called from the
+.I read
+and
+.I write
+service functions respectfully to handle
+calls on the
+.I afid.
 .PP
 If the 
 .B chatty9p

Re: [9front] [PATCH] remove /srv file reference from sam(1) and adding auth* function information to 9p(2)

[ori]

Quoth Jacob Moody <moody@mail.posixcafe.org>:
> Hello,
> 
> I have two quick man page patches. The first removes the references to the now deleted
> /srv command file used by sam from the man pages.
> The other documents that auth* helper functions within lib9p in 9p(2)
> 
> Thanks,
> moody
> 

Looks ok, you have commit access?