[src/trunk]: src/lib/libipsec sync manpage with latest kame.

[itojun <itojun%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8b314974eb46
branches:  trunk
changeset: 514382:8b314974eb46
user:      itojun <itojun%NetBSD.org@localhost>
date:      Fri Aug 31 09:53:23 2001 +0000

description:
sync manpage with latest kame.

diffstat:

 lib/libipsec/ipsec_set_policy.3 |  26 ++++++++++++++++++--------
 lib/libipsec/ipsec_strerror.3   |  21 +++++++++++++--------
 lib/libipsec/policy_parse.y     |   3 ++-
 lib/libipsec/policy_token.l     |   5 +++--
 4 files changed, 36 insertions(+), 19 deletions(-)

diffs (131 lines):

diff -r 39f89fab9aeb -r 8b314974eb46 lib/libipsec/ipsec_set_policy.3
--- a/lib/libipsec/ipsec_set_policy.3   Fri Aug 31 09:00:29 2001 +0000
+++ b/lib/libipsec/ipsec_set_policy.3   Fri Aug 31 09:53:23 2001 +0000
@@ -1,5 +1,5 @@
-.\"    $NetBSD: ipsec_set_policy.3,v 1.8 2001/04/06 07:04:31 itojun Exp $
-.\"    $KAME: ipsec_set_policy.3,v 1.14 2001/04/06 07:00:46 itojun Exp $
+.\"    $NetBSD: ipsec_set_policy.3,v 1.9 2001/08/31 09:53:23 itojun Exp $
+.\"    $KAME: ipsec_set_policy.3,v 1.15 2001/08/17 07:21:36 itojun Exp $
 .\"
 .\" Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project.
 .\" All rights reserved.
@@ -62,6 +62,8 @@
 .Fa policy .
 .Fn ipsec_set_policy
 will return the buffer of IPsec policy specification structure.
+The buffer is dynamically allocated, and must be freed by the caller by calling
+.Xr free 3 .
 .Pp
 You may want the length of the generated buffer such when calling
 .Xr setsockopt 2 .
@@ -168,6 +170,15 @@
 .Ar src
 is the other node
 .Pq peer .
+If
+.Ar mode
+is
+.Li transport ,
+Both
+.Ar src
+and
+.Ar dst
+can be omited. 
 .Pp
 .Ar level
 must be set to one of the following:
@@ -235,12 +246,11 @@
 .Pq long lines are wrapped for readability :
 .Bd -literal -offset indent
 in discard
-out ipsec esp/transport/10.1.1.1-10.1.1.2/require
-in ipsec ah/transport/10.1.1.2-10.1.1.1/require
-out ipsec esp/transport/10.1.1.2-10.1.1.1/use
-        ah/tunnel/10.1.1.2-10.1.1.1/unique:1000
-in ipsec ipcomp/transport/10.1.1.2-10.1.1.1/use
-        esp/transport/10.1.1.2-10.1.1.1/use
+out ipsec esp/transport//require
+in ipsec ah/transport//require
+out ipsec esp/tunnel/10.1.1.2-10.1.1.1/use
+in ipsec ipcomp/transport//use
+        esp/transport//use
 .Ed
 .Sh RETURN VALUES
 .Fn ipsec_set_policy
diff -r 39f89fab9aeb -r 8b314974eb46 lib/libipsec/ipsec_strerror.3
--- a/lib/libipsec/ipsec_strerror.3     Fri Aug 31 09:00:29 2001 +0000
+++ b/lib/libipsec/ipsec_strerror.3     Fri Aug 31 09:53:23 2001 +0000
@@ -1,5 +1,5 @@
-.\"    $NetBSD: ipsec_strerror.3,v 1.8 2000/07/30 02:38:36 itojun Exp $
-.\"    $KAME: ipsec_strerror.3,v 1.7 2000/07/30 00:45:45 itojun Exp $
+.\"    $NetBSD: ipsec_strerror.3,v 1.9 2001/08/31 09:53:23 itojun Exp $
+.\"    $KAME: ipsec_strerror.3,v 1.9 2001/08/17 07:21:36 itojun Exp $
 .\"
 .\" Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project.
 .\" All rights reserved.
@@ -50,10 +50,10 @@
 .Pp
 .Dl extern int ipsec_errcode;
 .Pp
-which is used to pass error code from IPsec policy manipulation library
-to user program.
+which is used to pass an error code from IPsec policy manipulation library
+to an user program.
 .Fn ipsec_strerror
-can be used to obtain error message string for the error code.
+can be used to obtain the error message string for the error code.
 .Pp
 The array pointed to is not to be modified by the program.
 Since
@@ -77,7 +77,12 @@
 .Xr ipsec_set_policy 3
 .\"
 .Sh HISTORY
-The functions first appeared in WIDE/KAME IPv6 protocol stack kit.
+.Fn ipsec_strerror
+first appeared in WIDE/KAME IPv6 protocol stack kit.
 .\"
-.\" .Sh BUGS
-.\" (to be written)
+.Sh BUGS
+.Fn ipsec_strerror
+will return its result which may be overwritten by subsequent calls.
+.Pp
+.Va ipsec_errcode
+is not thread safe.
diff -r 39f89fab9aeb -r 8b314974eb46 lib/libipsec/policy_parse.y
--- a/lib/libipsec/policy_parse.y       Fri Aug 31 09:00:29 2001 +0000
+++ b/lib/libipsec/policy_parse.y       Fri Aug 31 09:53:23 2001 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: policy_parse.y,v 1.6 2001/03/30 16:12:44 agc Exp $     */
+/*     $NetBSD: policy_parse.y,v 1.7 2001/08/31 09:53:23 itojun Exp $  */
 /*     $KAME: policy_parse.y,v 1.10 2000/05/07 05:25:03 itojun Exp $   */
 
 /*
@@ -85,6 +85,7 @@
 static caddr_t policy_parse __P((char *msg, int msglen));
 
 extern void __policy__strbuffer__init__ __P((char *msg));
+extern int yyparse __P((void));
 extern int yylex __P((void));
 
 extern char *__libyytext;      /*XXX*/
diff -r 39f89fab9aeb -r 8b314974eb46 lib/libipsec/policy_token.l
--- a/lib/libipsec/policy_token.l       Fri Aug 31 09:00:29 2001 +0000
+++ b/lib/libipsec/policy_token.l       Fri Aug 31 09:53:23 2001 +0000
@@ -1,5 +1,5 @@
-/*     $NetBSD: policy_token.l,v 1.5 2000/07/04 04:41:55 itojun Exp $  */
-/*     $KAME: policy_token.l,v 1.10 2000/07/04 04:03:33 itojun Exp $   */
+/*     $NetBSD: policy_token.l,v 1.6 2001/08/31 09:53:23 itojun Exp $  */
+/*     $KAME: policy_token.l,v 1.11 2000/12/01 10:08:29 sakane Exp $   */
 
 /*
  * Copyright (C) 1995, 1996, 1997, 1998, and 1999 WIDE Project.
@@ -57,6 +57,7 @@
 %}
 
 %option noyywrap
+%option nounput
 
 /* common section */
 nl             \n