From 30f6ae144c291409de3657c4bbbaf4983a516772 Mon Sep 17 00:00:00 2001 From: rsc Date: Sun, 13 Feb 2005 23:44:12 +0000 Subject: man --- man/man3/INDEX | 3 ++ man/man3/authsrv.3 | 2 +- man/man3/dial.3 | 108 +++++++++++++++++++++++++++------------------------- man/man3/dsa.3 | 12 +++++- man/man3/readcons.3 | 4 +- 5 files changed, 74 insertions(+), 55 deletions(-) (limited to 'man/man3') diff --git a/man/man3/INDEX b/man/man3/INDEX index b64cc21e..86c5369f 100644 --- a/man/man3/INDEX +++ b/man/man3/INDEX @@ -282,6 +282,8 @@ accept dial.3 announce dial.3 dial dial.3 dialparse dial.3 +freenetconninfo dial.3 +getnetconninfo dial.3 listen dial.3 netmkaddr dial.3 reject dial.3 @@ -340,6 +342,7 @@ stringnbg draw.3 stringnbgop draw.3 stringnop draw.3 stringop draw.3 +asn1toDSApriv dsa.3 dsa dsa.3 dsagen dsa.3 dsaprivalloc dsa.3 diff --git a/man/man3/authsrv.3 b/man/man3/authsrv.3 index 6b64ed8e..a0b68578 100644 --- a/man/man3/authsrv.3 +++ b/man/man3/authsrv.3 @@ -212,7 +212,7 @@ to recieve an answer. .SH SOURCE .B \*9/src/libauthsrv .SH SEE ALSO -.IR netkey (1), +.IR passwd (1), .IR dial (3), Plan 9's \fIauthsrv\fR(6). diff --git a/man/man3/dial.3 b/man/man3/dial.3 index 0c8c96ad..7177e53e 100644 --- a/man/man3/dial.3 +++ b/man/man3/dial.3 @@ -1,6 +1,6 @@ .TH DIAL 3 .SH NAME -dial, announce, listen, accept, reject, netmkaddr, dialparse \- make and break network connections +dial, announce, listen, accept, reject, netmkaddr, getnetconninfo, freenetconninfo, dialparse \- make and break network connections .SH SYNOPSIS .B #include .br @@ -26,12 +26,12 @@ char* netmkaddr(char *addr, char *defnet, char *defservice) .\" .PP .\" .B .\" void setnetmtpt(char *to, int tolen, char *from) -.\" .PP -.\" .B -.\" NetConnInfo* getnetconninfo(char *conndir, int fd) -.\" .PP -.\" .B -.\" void freenetconninfo(NetConnINfo*) +.PP +.B +NetConnInfo* getnetconninfo(char *dir, int fd) +.PP +.B +void freenetconninfo(NetConnINfo*) .PP .B int dialparse(char *addr, char **net, char **unix, @@ -94,19 +94,19 @@ will try in succession all networks in common between source and destination until a call succeeds. It returns a file descriptor open for reading and writing the -.B data -file in the line directory. -The -.B addr -file in the line directory contains the address called. -.\" If the network allows the local address to be set, -.\" as is the case with UDP and TCP port numbers, and -.\" .IR local -.\" is non-zero, the local address will be set to -.\" .IR local . +call. +.\" .B data +.\" file in the line directory. +.\" The +.\" .B addr +.\" file in the line directory contains the address called. +If the network allows the local address to be set, +as is the case with UDP and TCP port numbers, and +.IR local +is non-zero, the local address will be set to +.IR local . .IR Dial 's -.IR local , -.IR dir , +.IR dir and .I cfdp arguments @@ -166,39 +166,41 @@ It returns a pointer to static data holding the actual address to use. parses a network address as described above into a network name, a Unix domain socket address, an IPv4 host address, and an IPv4 port number. -.\" .PP -.\" .I Getnetconninfo -.\" returns a structure containing information about a -.\" network connection. The structure is: -.\" .EX -.\" typedef struct NetConnInfo NetConnInfo; -.\" struct NetConnInfo -.\" { -.\" char *dir; /* connection directory */ -.\" char *root; /* network root */ -.\" char *spec; /* binding spec */ -.\" char *lsys; /* local system */ -.\" char *lserv; /* local service */ -.\" char *rsys; /* remote system */ -.\" char *rserv; /* remote service */ -.\" }; -.\" .EE -.\" .PP -.\" The information is obtained from the connection directory, -.\" .IR conndir . -.\" If -.\" .I conndir -.\" is nil, the directory is obtained by performing -.\" .IR fd2path (3) -.\" on -.\" .IR fd . -.\" .I Getnetconninfo -.\" returns either a completely specified structure, or -.\" nil if either the structure can't be allocated or the -.\" network directory can't be determined. -.\" The structure -.\" is freed using -.\" .IR freenetconninfo . +.PP +.I Getnetconninfo +returns a structure containing information about a +network connection. The structure is: +.PP +.EX + typedef struct NetConnInfo NetConnInfo; + struct NetConnInfo + { + char *dir; /* connection directory */ + char *root; /* network root */ + char *spec; /* binding spec */ + char *lsys; /* local system */ + char *lserv; /* local service */ + char *rsys; /* remote system */ + char *rserv; /* remote service */ + char *laddr; /* local address */ + char *raddr; /* remote address */ + }; +.EE +.PP +The information is obtained from the +`line directory' +.IR dir , +or if +.I dir +is nil, from the connection file descriptor +.IR fd . +.I Getnetconninfo +returns either a completely specified structure, or +nil if either the structure can't be allocated or the +network directory can't be determined. +The structure +is freed using +.IR freenetconninfo . .\" .PP .\" .I Setnetmtpt .\" copies the name of the network mount point into @@ -307,6 +309,8 @@ bekremvax(void) .B \*9/src/lib9/announce.c .br .B \*9/src/lib9/_p9dialparse.c +.br +.B \*9/src/lib9/getnetconn.c .SH DIAGNOSTICS .IR Dial , .IR announce , diff --git a/man/man3/dsa.3 b/man/man3/dsa.3 index c29d2875..41532b89 100644 --- a/man/man3/dsa.3 +++ b/man/man3/dsa.3 @@ -1,6 +1,6 @@ .TH DSA 3 .SH NAME -dsagen, dsasign, dsaverify, dsapuballoc, dsapubfree, dsaprivalloc, dsaprivfree, dsasigalloc, dsasigfree, dsaprivtopub - digital signature algorithm +asn1toDSApriv, dsagen, dsasign, dsaverify, dsapuballoc, dsapubfree, dsaprivalloc, dsaprivfree, dsasigalloc, dsasigfree, dsaprivtopub - digital signature algorithm .SH SYNOPSIS .B #include .br @@ -39,6 +39,9 @@ void dsasigfree(DSAsig*) .PP .B DSApub* dsaprivtopub(DSApriv*) +.PP +.B +DSApriv* asn1toDSApriv(uchar *priv, int npriv) .SH DESCRIPTION .PP DSA is the NIST approved digital signature algorithm. The owner of a key publishes @@ -120,6 +123,13 @@ The routines and .I dsasigfree are provided to manage signature storage. +.PP +.I Asn1toDSApriv +converts an ASN1 formatted DSA private key into the corresponding +.B DSApriv +structure; see +.IR rsa (3) +for other ASN1 routines. .SH SOURCE .B \*9/src/libsec .SH SEE ALSO diff --git a/man/man3/readcons.3 b/man/man3/readcons.3 index 1f5d9865..dd284b97 100644 --- a/man/man3/readcons.3 +++ b/man/man3/readcons.3 @@ -29,7 +29,9 @@ If is non-zero, the input is not echoed to the screen. .SH EXAMPLE A stripped-down version of -.IR netkey (1): +.I netkey +(see +.IR passwd (1)): .IP .EX pass = readcons("password", nil, 1); -- cgit v1.2.3