[src/trunk]: src/usr.bin/rpcgen One step closer to reality:

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

details:   https://anonhg.NetBSD.org/src/rev/726c294f23c7
branches:  trunk
changeset: 566553:726c294f23c7
user:      christos <christos%NetBSD.org@localhost>
date:      Wed May 12 15:58:12 2004 +0000

description:
One step closer to reality:
- missing flags described
- synopsis was wrong
- explain -b better

diffstat:

 usr.bin/rpcgen/rpcgen.1 |  89 ++++++++++++++++++++++++++++++++++++------------
 1 files changed, 66 insertions(+), 23 deletions(-)

diffs (174 lines):

diff -r fd0e0436c9b0 -r 726c294f23c7 usr.bin/rpcgen/rpcgen.1
--- a/usr.bin/rpcgen/rpcgen.1   Wed May 12 15:44:28 2004 +0000
+++ b/usr.bin/rpcgen/rpcgen.1   Wed May 12 15:58:12 2004 +0000
@@ -1,7 +1,7 @@
-.\"    $NetBSD: rpcgen.1,v 1.17 2004/05/12 13:02:01 kleink Exp $
+.\"    $NetBSD: rpcgen.1,v 1.18 2004/05/12 15:58:12 christos Exp $
 .\" from: @(#)rpcgen.new.1     1.1 90/11/09 TIRPC 1.0; from 40.10 of 10/10/89
 .\" Copyright (c) 1988,1990 Sun Microsystems, Inc. - All Rights Reserved.
-.Dd May 11, 2004
+.Dd May 12, 2004
 .Dt RPCGEN 1
 .Sh NAME
 .Nm rpcgen
@@ -10,17 +10,22 @@
 .Nm
 .Ar infile
 .Nm
-.Op Fl D Op Ar name=value
+.Op Fl a
 .Op Fl A
+.Op Fl b
+.Op Fl C
+.Op Fl D Ar name Op =value
+.Op Fl i Ar size
+.Op Fl I
+.Op Fl K Ar secs
+.Op Fl L
 .Op Fl M
+.Op Fl N
 .Op Fl T
-.Op Fl K Ar secs
+.Op Fl v
+.Op Fl Y Ar pathname
 .Ar infile
 .Nm
-.Op Fl b
-.Op Fl I
-.Op Fl L
-.Op Fl M
 .Fl c Li |
 .Fl h Li |
 .Fl l Li |
@@ -28,16 +33,15 @@
 .Fl t Li |
 .Fl S\&c Li |
 .Fl S\&s
+.\" .Fl S\&m
 .Op Fl o Ar outfile
 .Op Ar infile
 .Nm
-.Fl c Li |
-.Ar nettype
+.Op Fl s Ar nettype
 .Op Fl o Ar outfile
 .Op Ar infile
 .Nm
-.Fl s Li |
-.Ar netid
+.Op Fl n Ar netid
 .Op Fl o Ar outfile
 .Op Ar infile
 .Sh DESCRIPTION
@@ -225,9 +229,19 @@
 .Bl -tag -width indent
 .It Fl a
 Generate all the files including sample code for client and server side.
+.It Fl A
+Generate an
+.Fn svc_caller
+function.
 .It Fl b
 Compile stubs in "backwards compatible" mode, disabling support for
-transport-independant RPC.
+transport-independent RPC.
+The
+.Fl b
+should always be specified when generating files for
+.Nx ,
+since there is no transport-independent RPC support in
+.Nx .
 .It Fl c
 Compile into
 .Tn XDR
@@ -258,6 +272,21 @@
 header file which supports
 .Tn RPC
 dispatch tables.
+.It Fl i Ar size
+Size to decide when to start generating inline code.
+The default size is 3.
+.It Fl I
+Support
+.Xr inetd 8
+in the server side stubs.
+Servers generated using this flag can either be standalone or
+started from
+.Xr inetd 8 .
+If a server is started as standalone, then it places itself
+in the background, unless
+.Dv RCP_SVC_FG
+is defined, or the server is compiled without
+.Fl I .
 .It Fl K Ar secs
 By default, services created using
 .Nm
@@ -311,16 +340,6 @@
 wrappers, etc.) must be built either with or without the
 .Fl M
 flag.
-.It Fl n Ar netid
-Compile into server-side stubs for the transport
-specified by
-.Ar netid .
-There should be an entry for
-.Ar netid
-in the
-netconfig database.
-This option may be specified more than once,
-so as to compile a server that serves multiple transports.
 .It Fl N
 Use the newstyle of
 .Nm .
@@ -333,6 +352,16 @@
 .Nm
 generated code.
 The newstyle is not the default case because of backward compatibility.
+.It Fl n Ar netid
+Compile into server-side stubs for the transport
+specified by
+.Ar netid .
+There should be an entry for
+.Ar netid
+in the
+netconfig database.
+This option may be specified more than once,
+so as to compile a server that serves multiple transports.
 .It Fl o Ar outfile
 Specify the name of the output file.
 If none is specified,
@@ -342,6 +371,12 @@
 .Fl m Fl n Fl s
 modes only
 .Pc
+.It Fl n Ar netid
+Specify the transport for the server-side stubs. 
+.Ar netid
+should be defined in
+.Xr netconfig 5 .
+This option can be repeated in order to support more than one transports.
 .It Fl s Ar nettype
 Compile into server-side stubs for all the
 transports belonging to the class
@@ -377,6 +412,8 @@
 Generate skeleton code for the remote procedures on the server side.
 You would need
 to fill in the actual code for the remote procedures.
+.\" .It Fl S\&m
+.\" Generate a sample Makefile that can be used to compile the application.
 .It Fl t
 Compile into
 .Tn RPC
@@ -385,6 +422,12 @@
 Generate the code to support
 .Tn RPC
 dispatch tables.
+.It Fl v
+Display the version number.
+.It Fl Y Ar pathname
+Specify the directory where
+.Nm
+looks for the C pre-processor.
 .El
 .Pp
 The options