From 12fdfd7b841d93e02a1d26e8e720290921107972 Mon Sep 17 00:00:00 2001 From: rsc Date: Fri, 14 Jan 2005 19:27:13 +0000 Subject: renamed --- man/man3/9pcmdbuf.3 | 118 ---------------------------------------------------- 1 file changed, 118 deletions(-) delete mode 100644 man/man3/9pcmdbuf.3 (limited to 'man/man3/9pcmdbuf.3') diff --git a/man/man3/9pcmdbuf.3 b/man/man3/9pcmdbuf.3 deleted file mode 100644 index cd1c7318..00000000 --- a/man/man3/9pcmdbuf.3 +++ /dev/null @@ -1,118 +0,0 @@ -.TH 9PCMDBUF 3 -.SH NAME -Cmdbuf, parsecmd, respondcmderror, lookupcmd \- control message parsing -.SH SYNOPSIS -.ft L -.nf -#include -#include -#include -#include -#include <9p.h> -.fi -.PP -.ft L -.nf -.ta \w'\fL1234'u +\w'\fL12345678'u -typedef struct Cmdbuf -{ - char *buf; - char **f; - int nf; -} Cmdbuf; - -typedef struct Cmdtab -{ - int index; - char *cmd; - int narg; -}; - -Cmdbuf *parsecmd(char *p, int n) -Cmdtab *lookupcmd(Cmdbuf *cb, Cmdtab *tab, int ntab) -void respondcmderror(Req *r, Cmdbuf *cb, char *fmt, ...) -.fi -.SH DESCRIPTION -These data structures and functions provide parsing of textual control messages. -.PP -.I Parsecmd -treats the -.I n -bytes at -.I p -(which need not be NUL-terminated) as a UTF string and splits it -using -.I tokenize -(see -.IR getfields (3)). -It returns a -.B Cmdbuf -structure holding pointers to each field in the message. -.PP -.I Lookupcmd -walks through the array -.IR ctab , -which has -.I ntab -entries, -looking for the first -.B Cmdtab -that matches the parsed command. -(If the parsed command is empty, -.I lookupcmd -returns nil immediately.) -A -.B Cmdtab -matches the command if -.I cmd -is equal to -.IB cb -> f [0] -or if -.I cmd -is -.LR * . -Once a matching -.B Cmdtab -has been found, if -.I narg -is not zero, then the parsed command -must have exactly -.I narg -fields (including the command string itself). -If the command has the wrong number of arguments, -.I lookupcmd -returns nil. -Otherwise, it returns a pointer to the -.B Cmdtab -entry. -If -.I lookupcmd -does not find a matching command at all, -it returns nil. -Whenever -.I lookupcmd -returns nil, it sets the system error string. -.PP -.I Respondcmderror -resoponds to request -.I r -with an error of the form -`\fIfmt\fB:\fI cmd\fR,' -where -.I fmt -is the formatted string and -.I cmd -is a reconstruction of the parsed command. -Fmt -is often simply -.B "%r" . -.SH EXAMPLES -This interface is not used in any distributed 9P servers. -It was lifted from the Plan 9 kernel. -Almost any kernel driver -.RB ( \*9/src/9/*/dev*.c ) -is a good example. -.SH SOURCE -.B \*9/src/lib9p/parse.c -.SH SEE ALSO -.IR 9p (3) -- cgit v1.2.3