auto-import changelog data from man-pages-1.30-4.src.rpm
Fri Aug 04 2000 Trond Eivind Glomsrd <teg@redhat.com> - fixed bad header specification (#15364) - removed obsolete patches from package - updated the rest Wed Jul 12 2000 Prospector <bugzilla@redhat.com> - automatic rebuild Mon Jun 19 2000 Matt Wilson <msw@redhat.com> - defattr before docs in filelist Sat Jun 17 2000 Trond Eivind Glomsrd <teg@redhat.com> - updated to 1.30 Tue Jun 06 2000 Trond Eivind Glomsrd <teg@redhat.com> - use %{_tmppath} Wed May 31 2000 Trond Eivind Glomsrd <teg@redhat.com> - remove resolv.conf(5) - part of bind-utils Tue May 30 2000 Trond Eivind Glomsrd <teg@redhat.com> - Remove resolver, dlclose, dlerror, dlopen, dlsym as these are included in other packages. Tue May 30 2000 Trond Eivind Glomsrd <teg@redhat.com> - use %{_mandir) instead of /usr/man - verify and fix bug in mmap man page (#7382) - verify and fix missing data in recvfrom man page (#1736) - verify and fix missing data in putw man page (#10104) - fixed sendfile(2) man page (#5599) - fixed tzset man page (#11623) Mon May 15 2000 Trond Eivind Glomsrd <teg@redhat.com> - updated to 1.29 - split off other languages into separate RPMS Thu Mar 16 2000 Florian La Roche <Florian.LaRoche@redhat.com> - do not use group "man" Fri Mar 03 2000 Cristian Gafton <gafton@redhat.com> - don't apply the netman-cvs man pages anymore, as they seem to be really out of date Sat Feb 05 2000 Cristian Gafton <gafton@redhat.com> - put back man3/resolver.3 Fri Feb 04 2000 Cristian Gafton <gafton@redhat.com> - remove non-man pages (#7814) Fri Feb 04 2000 Matt Wilson <msw@redhat.com> - exclude dir.1 and vdir.1 (these are in the fileutils package) Thu Feb 03 2000 Cristian Gafton <gafton@redhat.com> - version 1.28 Fri Nov 05 1999 Michael K. Johnson <johnsonm@redhat.com> - Fixed SIGILL, SIGQUIT in signals.7 Wed Oct 06 1999 Cristian Gafton <gafton@redhat.com> - fox man page for getcwd Wed Sep 22 1999 Cristian Gafton <gafton@redhat.com> - added man pages for set/getcontext Tue Sep 14 1999 Bill Nottingham <notting@redhat.com> - remove some bad man pages Mon Sep 13 1999 Preston Brown <pbrown@redhat.com> - czech, german, spanish, russian man pages Thu Sep 09 1999 Cristian Gafton <gafton@redhat.com> - version 1.26 - add french man pages - add italian man pages Fri Jul 23 1999 Jeff Johnson <jbj@redhat.com> - update to 1.25. Fri Apr 16 1999 Cristian Gafton <gafton@redhat.com> - fiox man page fro ftw Mon Apr 05 1999 Cristian Gafton <gafton@redhat.com> - spellnig fixse Tue Mar 30 1999 Bill Nottingham <notting@redhat.com> - updated to 1.23 Thu Mar 25 1999 Cristian Gafton <gafton@redhat.com> - added kernel net manpages Mon Mar 22 1999 Erik Troan <ewt@redhat.com> - updated printf man page - added rpcgen man page Sun Mar 21 1999 Cristian Gafton <gafton@redhat.com> - auto rebuild in the new build environment (release 6) Thu Mar 18 1999 Cristian Gafton <gafton@redhat.com> - leave the lilo man pages alone (oops) Fri Feb 12 1999 Michael Maher <mike@redhat.com> - fixed bug #413 Mon Jan 18 1999 Cristian Gafton <gafton@redhat.com> - remove lilo man pages too - got rebuilt for 6.0 Tue Sep 08 1998 Cristian Gafton <gafton@redhat.com> - version 1.21 Sat Jun 20 1998 Jeff Johnson <jbj@redhat.com> - updated to 1.20 Wed May 06 1998 Cristian Gafton <gafton@redhat.com> - get rid of the modutils man pages - updated to 1.19 Fri Apr 24 1998 Prospector System <bugs@redhat.com> - translations modified for de, fr, tr Wed Apr 08 1998 Erik Troan <ewt@redhat.com> - updated to 1.18 Sun Oct 19 1997 Erik Troan <ewt@redhat.com> - updated to 1.17 - moved build root to /var Thu Jul 31 1997 Erik Troan <ewt@redhat.com> - made a noarch package
This commit is contained in:
parent
50c85e9974
commit
8f07cacb4e
@ -0,0 +1,3 @@
|
|||||||
|
man-pages-1.30.tar.bz2
|
||||||
|
man2.tar.gz
|
||||||
|
netman-cvs.tar.gz
|
208
man-pages.spec
Normal file
208
man-pages.spec
Normal file
@ -0,0 +1,208 @@
|
|||||||
|
Summary: Man (manual) pages from the Linux Documentation Project.
|
||||||
|
Name: man-pages
|
||||||
|
Version: 1.30
|
||||||
|
Release: 4
|
||||||
|
Copyright: distributable
|
||||||
|
Group: Documentation
|
||||||
|
Source0: ftp://ftp.win.tue.nl/pub/linux/docs/manpages/man-pages-%{version}.tar.bz2
|
||||||
|
Source1: rpcgen.1
|
||||||
|
Source2: netman-cvs.tar.gz
|
||||||
|
Source9: man2.tar.gz
|
||||||
|
Patch1: man-pages-1.23-spell.patch
|
||||||
|
Patch2: man-pages-1.26-getcwd.patch
|
||||||
|
Patch3: man-pages-1.30-tzset.patch
|
||||||
|
Patch4: man-pages-1.30-ipheader.patch
|
||||||
|
Buildroot: %{_tmppath}/%{name}-%{version}-root
|
||||||
|
Autoreqprov: false
|
||||||
|
BuildArchitectures: noarch
|
||||||
|
|
||||||
|
%description
|
||||||
|
A large collection of man pages (documentation) from the Linux
|
||||||
|
Documentation Project (LDP). The man pages are organized into the
|
||||||
|
following sections: Section 1, user commands (intro only); Section 2,
|
||||||
|
system calls; Section 3, libc calls; Section 4, devices (e.g., hd,
|
||||||
|
sd); Section 5, file formats and protocols (e.g., wtmp, /etc/passwd,
|
||||||
|
nfs); Section 6, games (intro only); Section 7, conventions, macro
|
||||||
|
packages, etc. (e.g., nroff, ascii); and Section 8, system
|
||||||
|
administration (intro only).
|
||||||
|
|
||||||
|
%prep
|
||||||
|
%setup -q -a 9
|
||||||
|
|
||||||
|
%patch1 -p1
|
||||||
|
%patch2 -p1
|
||||||
|
%patch3 -p1
|
||||||
|
%patch4 -p1
|
||||||
|
cp -a %{SOURCE1} man1
|
||||||
|
|
||||||
|
%build
|
||||||
|
rm -fv man1/README
|
||||||
|
mv -fv man1/COPYING .
|
||||||
|
rm -fv man1/{chgrp,chmod,chown,cp,dd,df,dircolors,du,install}.1
|
||||||
|
rm -fv man1/{ln,ls,mkdir,mkfifo,mknod,mv,rm,rmdir,touch}.1
|
||||||
|
rm -fv man1/{dir,vdir}.1
|
||||||
|
rm -fv man2/modules.2 man2/quotactl.2 man2/get_kernel_syms.2
|
||||||
|
rm -fv man2/{create,delete,init,query}_module.2
|
||||||
|
rm -fv man3/getnetent.3
|
||||||
|
rm -fv man4/console.4
|
||||||
|
rm -fv man5/exports.5
|
||||||
|
rm -fv man5/nfs.5
|
||||||
|
rm -fv man5/fstab.5
|
||||||
|
rm -fv man5/resolver.5
|
||||||
|
rm -fv man3/dlclose.3
|
||||||
|
rm -fv man3/dlerror.3
|
||||||
|
rm -fv man3/dlopen.3
|
||||||
|
rm -fv man3/dlsym.3
|
||||||
|
rm -fv man5/resolv.conf.5
|
||||||
|
|
||||||
|
find . -name "*sudo*" -exec rm {} \;
|
||||||
|
|
||||||
|
%install
|
||||||
|
rm -rf $RPM_BUILD_ROOT
|
||||||
|
|
||||||
|
mkdir -p $RPM_BUILD_ROOT%{_mandir}
|
||||||
|
for n in 1 2 3 4 5 6 7 8; do
|
||||||
|
mkdir $RPM_BUILD_ROOT%{_mandir}/man$n
|
||||||
|
done
|
||||||
|
for n in man?/*; do
|
||||||
|
cp -a $n $RPM_BUILD_ROOT%{_mandir}/$n
|
||||||
|
done
|
||||||
|
|
||||||
|
%clean
|
||||||
|
rm -rf $RPM_BUILD_ROOT
|
||||||
|
|
||||||
|
%files
|
||||||
|
%defattr(0644,root,root,0755)
|
||||||
|
%doc README man-pages-1.30.Announce
|
||||||
|
%{_mandir}/man*/*
|
||||||
|
|
||||||
|
%changelog
|
||||||
|
* Fri Aug 04 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- fixed bad header specification (#15364)
|
||||||
|
- removed obsolete patches from package
|
||||||
|
- updated the rest
|
||||||
|
|
||||||
|
* Wed Jul 12 2000 Prospector <bugzilla@redhat.com>
|
||||||
|
- automatic rebuild
|
||||||
|
|
||||||
|
* Mon Jun 19 2000 Matt Wilson <msw@redhat.com>
|
||||||
|
- defattr before docs in filelist
|
||||||
|
|
||||||
|
* Sun Jun 17 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- updated to 1.30
|
||||||
|
|
||||||
|
* Tue Jun 06 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- use %%{_tmppath}
|
||||||
|
|
||||||
|
* Wed May 31 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- remove resolv.conf(5) - part of bind-utils
|
||||||
|
|
||||||
|
* Tue May 30 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- Remove resolver, dlclose, dlerror, dlopen, dlsym as these
|
||||||
|
are included in other packages.
|
||||||
|
|
||||||
|
* Tue May 30 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- use %%{_mandir) instead of /usr/man
|
||||||
|
- verify and fix bug in mmap man page (#7382)
|
||||||
|
- verify and fix missing data in recvfrom man page (#1736)
|
||||||
|
- verify and fix missing data in putw man page (#10104)
|
||||||
|
- fixed sendfile(2) man page (#5599)
|
||||||
|
- fixed tzset man page (#11623)
|
||||||
|
|
||||||
|
* Mon May 15 2000 Trond Eivind Glomsrød <teg@redhat.com>
|
||||||
|
- updated to 1.29
|
||||||
|
- split off other languages into separate RPMS
|
||||||
|
|
||||||
|
* Thu Mar 16 2000 Florian La Roche <Florian.LaRoche@redhat.com>
|
||||||
|
- do not use group "man"
|
||||||
|
|
||||||
|
* Fri Mar 03 2000 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- don't apply the netman-cvs man pages anymore, as they seem to be really
|
||||||
|
out of date
|
||||||
|
|
||||||
|
* Sat Feb 05 2000 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- put back man3/resolver.3
|
||||||
|
|
||||||
|
* Fri Feb 04 2000 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- remove non-man pages (#7814)
|
||||||
|
|
||||||
|
* Fri Feb 4 2000 Matt Wilson <msw@redhat.com>
|
||||||
|
- exclude dir.1 and vdir.1 (these are in the fileutils package)
|
||||||
|
|
||||||
|
* Thu Feb 03 2000 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- version 1.28
|
||||||
|
|
||||||
|
* Fri Nov 05 1999 Michael K. Johnson <johnsonm@redhat.com>
|
||||||
|
- Fixed SIGILL, SIGQUIT in signals.7
|
||||||
|
|
||||||
|
* Wed Oct 06 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- fox man page for getcwd
|
||||||
|
|
||||||
|
* Wed Sep 22 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- added man pages for set/getcontext
|
||||||
|
|
||||||
|
* Tue Sep 14 1999 Bill Nottingham <notting@redhat.com>
|
||||||
|
- remove some bad man pages
|
||||||
|
|
||||||
|
* Mon Sep 13 1999 Preston Brown <pbrown@redhat.com>
|
||||||
|
- czech, german, spanish, russian man pages
|
||||||
|
|
||||||
|
* Thu Sep 09 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- version 1.26
|
||||||
|
- add french man pages
|
||||||
|
- add italian man pages
|
||||||
|
|
||||||
|
* Fri Jul 23 1999 Jeff Johnson <jbj@redhat.com>
|
||||||
|
- update to 1.25.
|
||||||
|
|
||||||
|
* Fri Apr 16 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- fiox man page fro ftw
|
||||||
|
|
||||||
|
* Mon Apr 05 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- spellnig fixse
|
||||||
|
|
||||||
|
* Tue Mar 30 1999 Bill Nottingham <notting@redhat.com>
|
||||||
|
- updated to 1.23
|
||||||
|
|
||||||
|
* Thu Mar 25 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- added kernel net manpages
|
||||||
|
|
||||||
|
* Mon Mar 22 1999 Erik Troan <ewt@redhat.com>
|
||||||
|
- updated printf man page
|
||||||
|
- added rpcgen man page
|
||||||
|
|
||||||
|
* Sun Mar 21 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- auto rebuild in the new build environment (release 6)
|
||||||
|
|
||||||
|
* Thu Mar 18 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- leave the lilo man pages alone (oops)
|
||||||
|
|
||||||
|
* Fri Feb 12 1999 Michael Maher <mike@redhat.com>
|
||||||
|
- fixed bug #413
|
||||||
|
|
||||||
|
* Mon Jan 18 1999 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- remove lilo man pages too
|
||||||
|
- got rebuilt for 6.0
|
||||||
|
|
||||||
|
* Tue Sep 08 1998 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- version 1.21
|
||||||
|
|
||||||
|
* Sat Jun 20 1998 Jeff Johnson <jbj@redhat.com>
|
||||||
|
- updated to 1.20
|
||||||
|
|
||||||
|
* Wed May 06 1998 Cristian Gafton <gafton@redhat.com>
|
||||||
|
- get rid of the modutils man pages
|
||||||
|
- updated to 1.19
|
||||||
|
|
||||||
|
* Fri Apr 24 1998 Prospector System <bugs@redhat.com>
|
||||||
|
- translations modified for de, fr, tr
|
||||||
|
|
||||||
|
* Wed Apr 08 1998 Erik Troan <ewt@redhat.com>
|
||||||
|
- updated to 1.18
|
||||||
|
|
||||||
|
* Sun Oct 19 1997 Erik Troan <ewt@redhat.com>
|
||||||
|
- updated to 1.17
|
||||||
|
- moved build root to /var
|
||||||
|
|
||||||
|
* Thu Jul 31 1997 Erik Troan <ewt@redhat.com>
|
||||||
|
- made a noarch package
|
434
rpcgen.1
Normal file
434
rpcgen.1
Normal file
@ -0,0 +1,434 @@
|
|||||||
|
.\" @(#)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.
|
||||||
|
.nr X
|
||||||
|
.if \nX=0 .ds x} rpcgen 1 "" "\&"
|
||||||
|
.if \nX=1 .ds x} rpcgen 1 ""
|
||||||
|
.if \nX=2 .ds x} rpcgen 1 "" "\&"
|
||||||
|
.if \nX=3 .ds x} rpcgen "" "" "\&"
|
||||||
|
.TH \*(x}
|
||||||
|
.SH NAME
|
||||||
|
\f4rpcgen\f1 \- an RPC protocol compiler
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.ft 4
|
||||||
|
.nf
|
||||||
|
rpcgen \f2infile\f4
|
||||||
|
.fi
|
||||||
|
.ft 1
|
||||||
|
.br
|
||||||
|
.ft 4
|
||||||
|
.nf
|
||||||
|
rpcgen [\-D\f2name\f4[=\f2value\f4]] [\-T] [\-K \f2secs\fP] \f2infile\f4
|
||||||
|
.fi
|
||||||
|
.ft 1
|
||||||
|
.br
|
||||||
|
.ft 4
|
||||||
|
.nf
|
||||||
|
rpcgen \-c|\-h|\-l|\-m|\-t [\-o \f2outfile\f4 ] \f2infile\f4
|
||||||
|
.fi
|
||||||
|
.ft 1
|
||||||
|
.br
|
||||||
|
.ft 4
|
||||||
|
.nf
|
||||||
|
rpcgen [\-I] \-s \f2nettype\f4 [\-o \f2outfile\f4] \f2infile\f4
|
||||||
|
.fi
|
||||||
|
.ft 1
|
||||||
|
.br
|
||||||
|
.ft 4
|
||||||
|
.nf
|
||||||
|
rpcgen \-n \f2netid\f4 [\-o \f2outfile\f4] \f2infile\f4
|
||||||
|
.ft 1
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.P
|
||||||
|
\f4rpcgen\f1
|
||||||
|
is a tool that generates C code to implement an RPC protocol.
|
||||||
|
The input to
|
||||||
|
\f4rpcgen\f1
|
||||||
|
is a language similar to C known as
|
||||||
|
RPC Language (Remote Procedure Call Language).
|
||||||
|
.P
|
||||||
|
\f4rpcgen\f1
|
||||||
|
is normally used as in the first synopsis where
|
||||||
|
it takes an input file and generates up to four output files.
|
||||||
|
If the
|
||||||
|
\f2infile\f1
|
||||||
|
is named
|
||||||
|
\f4proto.x\f1,
|
||||||
|
then
|
||||||
|
\f4rpcgen\f1
|
||||||
|
will generate a header file in
|
||||||
|
\f4proto.h\f1,
|
||||||
|
XDR routines in
|
||||||
|
\f4proto_xdr.c\f1,
|
||||||
|
server-side stubs in
|
||||||
|
\f4proto_svc.c\f1,
|
||||||
|
and client-side stubs in
|
||||||
|
\f4proto_clnt.c\f1.
|
||||||
|
With the
|
||||||
|
\f4\-T\f1
|
||||||
|
option,
|
||||||
|
it will also generate the RPC dispatch table in
|
||||||
|
\f4proto_tbl.i\f1.
|
||||||
|
With the
|
||||||
|
\f4\-Sc\f1
|
||||||
|
option,
|
||||||
|
it will also generate sample code which would illustrate how to use the
|
||||||
|
remote procedures on the client side. This code would be created in
|
||||||
|
\f4proto_client.c\f1.
|
||||||
|
With the
|
||||||
|
\f4\-Ss\f1
|
||||||
|
option,
|
||||||
|
it will also generate a sample server code which would illustrate how to write
|
||||||
|
the remote procedures. This code would be created in
|
||||||
|
\f4proto_server.c\f1.
|
||||||
|
.P
|
||||||
|
The server created can be started both by the port monitors
|
||||||
|
(for example, \f4inetd\f1 or \f4listen\f1)
|
||||||
|
or by itself.
|
||||||
|
When it is started by a port monitor,
|
||||||
|
it creates servers only for the transport for which
|
||||||
|
the file descriptor \f40\fP was passed.
|
||||||
|
The name of the transport must be specified
|
||||||
|
by setting up the environmental variable
|
||||||
|
\f4PM_TRANSPORT\f1.
|
||||||
|
When the server generated by
|
||||||
|
\f4rpcgen\f1
|
||||||
|
is executed,
|
||||||
|
it creates server handles for all the transports
|
||||||
|
specified in
|
||||||
|
\f4NETPATH\f1
|
||||||
|
environment variable,
|
||||||
|
or if it is unset,
|
||||||
|
it creates server handles for all the visible transports from
|
||||||
|
\f4/etc/netconfig\f1
|
||||||
|
file.
|
||||||
|
Note:
|
||||||
|
the transports are chosen at run time and not at compile time.
|
||||||
|
When the server is self-started,
|
||||||
|
it backgrounds itself by default.
|
||||||
|
A special define symbol
|
||||||
|
\f4RPC_SVC_FG\f1
|
||||||
|
can be used to run the server process in foreground.
|
||||||
|
.P
|
||||||
|
The second synopsis provides special features which allow
|
||||||
|
for the creation of more sophisticated RPC servers.
|
||||||
|
These features include support for user provided
|
||||||
|
\f4#defines\f1
|
||||||
|
and RPC dispatch tables.
|
||||||
|
The entries in the RPC dispatch table contain:
|
||||||
|
.RS
|
||||||
|
.PD 0
|
||||||
|
.TP 3
|
||||||
|
\(bu
|
||||||
|
pointers to the service routine corresponding to that procedure,
|
||||||
|
.TP
|
||||||
|
\(bu
|
||||||
|
a pointer to the input and output arguments
|
||||||
|
.TP
|
||||||
|
\(bu
|
||||||
|
the size of these routines
|
||||||
|
.PD
|
||||||
|
.RE
|
||||||
|
A server can use the dispatch table to check authorization
|
||||||
|
and then to execute the service routine;
|
||||||
|
a client library may use it to deal with the details of storage
|
||||||
|
management and XDR data conversion.
|
||||||
|
.P
|
||||||
|
The other three synopses shown above are used when
|
||||||
|
one does not want to generate all the output files,
|
||||||
|
but only a particular one.
|
||||||
|
Some examples of their usage is described in the
|
||||||
|
EXAMPLE
|
||||||
|
section below.
|
||||||
|
When
|
||||||
|
\f4rpcgen\f1
|
||||||
|
is executed with the
|
||||||
|
\f4\-s\f1
|
||||||
|
option,
|
||||||
|
it creates servers for that particular class of transports.
|
||||||
|
When
|
||||||
|
executed with the
|
||||||
|
\f4\-n\f1
|
||||||
|
option,
|
||||||
|
it creates a server for the transport specified by
|
||||||
|
\f2netid\f1.
|
||||||
|
If
|
||||||
|
\f2infile\f1
|
||||||
|
is not specified,
|
||||||
|
\f4rpcgen\f1
|
||||||
|
accepts the standard input.
|
||||||
|
.P
|
||||||
|
The C preprocessor,
|
||||||
|
\f4cc \-E\f1
|
||||||
|
[see \f4cc\fP(1)],
|
||||||
|
is run on the input file before it is actually interpreted by
|
||||||
|
\f4rpcgen\f1.
|
||||||
|
For each type of output file,
|
||||||
|
\f4rpcgen\f1
|
||||||
|
defines a special preprocessor symbol for use by the
|
||||||
|
\f4rpcgen\f1
|
||||||
|
programmer:
|
||||||
|
.P
|
||||||
|
.PD 0
|
||||||
|
.TP 12
|
||||||
|
\f4RPC_HDR\f1
|
||||||
|
defined when compiling into header files
|
||||||
|
.TP
|
||||||
|
\f4RPC_XDR\f1
|
||||||
|
defined when compiling into XDR routines
|
||||||
|
.TP
|
||||||
|
\f4RPC_SVC\f1
|
||||||
|
defined when compiling into server-side stubs
|
||||||
|
.TP
|
||||||
|
\f4RPC_CLNT\f1
|
||||||
|
defined when compiling into client-side stubs
|
||||||
|
.TP
|
||||||
|
\f4RPC_TBL\f1
|
||||||
|
defined when compiling into RPC dispatch tables
|
||||||
|
.PD
|
||||||
|
.P
|
||||||
|
Any line beginning with
|
||||||
|
`\f4%\f1'
|
||||||
|
is passed directly into the output file,
|
||||||
|
uninterpreted by
|
||||||
|
\f4rpcgen\f1.
|
||||||
|
.P
|
||||||
|
For every data type referred to in
|
||||||
|
\f2infile\f1,
|
||||||
|
\f4rpcgen\f1
|
||||||
|
assumes that there exists a
|
||||||
|
routine with the string
|
||||||
|
\f4xdr_\f1
|
||||||
|
prepended to the name of the data type.
|
||||||
|
If this routine does not exist in the RPC/XDR
|
||||||
|
library, it must be provided.
|
||||||
|
Providing an undefined data type
|
||||||
|
allows customization of XDR routines.
|
||||||
|
.br
|
||||||
|
.ne 10
|
||||||
|
.P
|
||||||
|
The following options are available:
|
||||||
|
.TP
|
||||||
|
\f4\-a\f1
|
||||||
|
Generate all the files including sample code for client and server side.
|
||||||
|
.TP
|
||||||
|
\f4\-b\f1
|
||||||
|
This generates code for the SunOS4.1 style of rpc. It is
|
||||||
|
for backward compatibilty. This is the default.
|
||||||
|
.TP
|
||||||
|
\f4\-5\f1
|
||||||
|
This generates code for the SysVr4 style of rpc. It is used by the
|
||||||
|
Transport Independent RPC that is in Svr4 systems.
|
||||||
|
By default rpcgen generates code for SunOS4.1 stype of rpc.
|
||||||
|
.TP
|
||||||
|
\f4\-c\f1
|
||||||
|
Compile into XDR routines.
|
||||||
|
.TP
|
||||||
|
\f4\-C\f1
|
||||||
|
Generate code in ANSI C. This option also generates code that could be
|
||||||
|
compiled with the C++ compiler. This is the default.
|
||||||
|
.TP
|
||||||
|
\f4\-k\f1
|
||||||
|
Generate code in K&R C. The default is ANSI C.
|
||||||
|
.TP
|
||||||
|
\f4\-D\f2name\f4[=\f2value\f4]\f1
|
||||||
|
Define a symbol
|
||||||
|
\f2name\f1.
|
||||||
|
Equivalent to the
|
||||||
|
\f4#define\f1
|
||||||
|
directive in the source.
|
||||||
|
If no
|
||||||
|
\f2value\f1
|
||||||
|
is given,
|
||||||
|
\f2value\f1
|
||||||
|
is defined as \f41\f1.
|
||||||
|
This option may be specified more than once.
|
||||||
|
.TP
|
||||||
|
\f4\-h\f1
|
||||||
|
Compile into
|
||||||
|
\f4C\f1
|
||||||
|
data-definitions (a header file).
|
||||||
|
\f4\-T\f1
|
||||||
|
option can be used in conjunction to produce a
|
||||||
|
header file which supports RPC dispatch tables.
|
||||||
|
.TP
|
||||||
|
\f4\-I\f1
|
||||||
|
Generate a service that can be started from inetd. The default is
|
||||||
|
to generate a static service that handles transports selected with \f4\-s\f1.
|
||||||
|
Using \f4\-I\f1 allows starting a service by either method.
|
||||||
|
.TP
|
||||||
|
\f4-K\f2 secs\f1
|
||||||
|
By default, services created using \f4rpcgen\fP wait \f4120\fP seconds
|
||||||
|
after servicing a request before exiting.
|
||||||
|
That interval can be changed using the \f4-K\fP flag.
|
||||||
|
To create a server that exits immediately upon servicing a request,
|
||||||
|
\f4-K\ 0\fP can be used.
|
||||||
|
To create a server that never exits, the appropriate argument is
|
||||||
|
\f4-K\ -1\fP.
|
||||||
|
.IP
|
||||||
|
When monitoring for a server,
|
||||||
|
some portmonitors, like
|
||||||
|
\f4listen\fP(1M),
|
||||||
|
.I always
|
||||||
|
spawn a new process in response to a service request.
|
||||||
|
If it is known that a server will be used with such a monitor, the
|
||||||
|
server should exit immediately on completion.
|
||||||
|
For such servers, \f4rpcgen\fP should be used with \f4-K\ -1\fP.
|
||||||
|
.TP
|
||||||
|
\f4\-l\f1
|
||||||
|
Compile into client-side stubs.
|
||||||
|
.TP
|
||||||
|
\f4\-m\f1
|
||||||
|
Compile into server-side stubs,
|
||||||
|
but do not generate a \(lqmain\(rq routine.
|
||||||
|
This option is useful for doing callback-routines
|
||||||
|
and for users who need to write their own
|
||||||
|
\(lqmain\(rq routine to do initialization.
|
||||||
|
.TP
|
||||||
|
\f4\-n \f2netid\f1
|
||||||
|
Compile into server-side stubs for the transport
|
||||||
|
specified by
|
||||||
|
\f2netid\f1.
|
||||||
|
There should be an entry for
|
||||||
|
\f2netid\f1
|
||||||
|
in the
|
||||||
|
netconfig database.
|
||||||
|
This option may be specified more than once,
|
||||||
|
so as to compile a server that serves multiple transports.
|
||||||
|
.TP
|
||||||
|
\f4\-N\f1
|
||||||
|
Use the newstyle of rpcgen. This allows procedures to have multiple arguments.
|
||||||
|
It also uses the style of parameter passing that closely resembles C. So, when
|
||||||
|
passing an argument to a remote procedure you do not have to pass a pointer to
|
||||||
|
the argument but the argument itself. This behaviour is different from the oldstyle
|
||||||
|
of rpcgen generated code. The newstyle is not the default case because of
|
||||||
|
backward compatibility.
|
||||||
|
.TP
|
||||||
|
\f4\-o \f2outfile\f1
|
||||||
|
Specify the name of the output file.
|
||||||
|
If none is specified,
|
||||||
|
standard output is used
|
||||||
|
(\f4\-c\f1,
|
||||||
|
\f4\-h\f1,
|
||||||
|
\f4\-l\f1,
|
||||||
|
\f4\-m\f1,
|
||||||
|
\f4\-n\f1,
|
||||||
|
\f4\-s\f1,
|
||||||
|
\f4\-s\Sc,
|
||||||
|
\f4\-s\Ss
|
||||||
|
and
|
||||||
|
\f4\-t\f1
|
||||||
|
modes only).
|
||||||
|
.TP
|
||||||
|
\f4\-s \f2nettype\f1
|
||||||
|
Compile into server-side stubs for all the
|
||||||
|
transports belonging to the class
|
||||||
|
\f2nettype\f1.
|
||||||
|
The supported classes are
|
||||||
|
\f4netpath\f1,
|
||||||
|
\f4visible\f1,
|
||||||
|
\f4circuit_n\f1,
|
||||||
|
\f4circuit_v\f1,
|
||||||
|
\f4datagram_n\f1,
|
||||||
|
\f4datagram_v\f1,
|
||||||
|
\f4tcp\f1,
|
||||||
|
and
|
||||||
|
\f4udp\f1
|
||||||
|
[see \f4rpc\fP(3N)
|
||||||
|
for the meanings associated with these classes].
|
||||||
|
This option may be specified more than once.
|
||||||
|
Note:
|
||||||
|
the transports are chosen at run time and not at compile time.
|
||||||
|
.TP
|
||||||
|
\f4\-Sc\f1
|
||||||
|
Generate sample code to show the use of remote procedure and how to bind
|
||||||
|
to the server before calling the client side stubs generated by rpcgen.
|
||||||
|
.TP
|
||||||
|
\f4\-Ss\f1
|
||||||
|
Generate skeleton code for the remote procedures on the server side. You would need
|
||||||
|
to fill in the actual code for the remote procedures.
|
||||||
|
.TP
|
||||||
|
\f4\-t\f1
|
||||||
|
Compile into RPC dispatch table.
|
||||||
|
.TP
|
||||||
|
\f4\-T\f1
|
||||||
|
Generate the code to support RPC dispatch tables.
|
||||||
|
.P
|
||||||
|
The options
|
||||||
|
\f4\-c\f1,
|
||||||
|
\f4\-h\f1,
|
||||||
|
\f4\-l\f1,
|
||||||
|
\f4\-m\f1,
|
||||||
|
\f4\-s\f1
|
||||||
|
and
|
||||||
|
\f4\-t\f1
|
||||||
|
are used exclusively to generate a particular type of file,
|
||||||
|
while the options
|
||||||
|
\f4\-D\f1
|
||||||
|
and
|
||||||
|
\f4\-T\f1
|
||||||
|
are global and can be used with the other options.
|
||||||
|
.br
|
||||||
|
.ne 5
|
||||||
|
.SH NOTES
|
||||||
|
The RPC Language does not support nesting of structures.
|
||||||
|
As a work-around,
|
||||||
|
structures can be declared at the top-level,
|
||||||
|
and their name used inside other structures in
|
||||||
|
order to achieve the same effect.
|
||||||
|
.P
|
||||||
|
Name clashes can occur when using program definitions,
|
||||||
|
since the apparent scoping does not really apply.
|
||||||
|
Most of these can be avoided by giving
|
||||||
|
unique names for programs,
|
||||||
|
versions,
|
||||||
|
procedures and types.
|
||||||
|
.P
|
||||||
|
The server code generated with
|
||||||
|
\f4\-n\f1
|
||||||
|
option refers to the transport indicated by
|
||||||
|
\f2netid\f1
|
||||||
|
and hence is very site specific.
|
||||||
|
.SH EXAMPLE
|
||||||
|
The following example:
|
||||||
|
.IP
|
||||||
|
.ft 4
|
||||||
|
$ rpcgen \-T prot.x
|
||||||
|
.ft 1
|
||||||
|
.P
|
||||||
|
generates the five files:
|
||||||
|
\f4prot.h\f1,
|
||||||
|
\f4prot_clnt.c\f1,
|
||||||
|
\f4prot_svc.c\f1,
|
||||||
|
\f4prot_xdr.c\f1
|
||||||
|
and
|
||||||
|
\f4prot_tbl.i\f1.
|
||||||
|
.P
|
||||||
|
The following example sends the C data-definitions (header file)
|
||||||
|
to the standard output.
|
||||||
|
.IP
|
||||||
|
.ft 4
|
||||||
|
$ rpcgen \-h prot.x
|
||||||
|
.ft 1
|
||||||
|
.P
|
||||||
|
To send the test version of the
|
||||||
|
\f4-DTEST\f1,
|
||||||
|
server side stubs for
|
||||||
|
all the transport belonging to the class
|
||||||
|
\f4datagram_n\f1
|
||||||
|
to standard output, use:
|
||||||
|
.IP
|
||||||
|
.ft 4
|
||||||
|
$ rpcgen \-s datagram_n \-DTEST prot.x
|
||||||
|
.ft 1
|
||||||
|
.P
|
||||||
|
To create the server side stubs for the transport indicated
|
||||||
|
by
|
||||||
|
\f2netid\f1
|
||||||
|
\f4tcp\f1,
|
||||||
|
use:
|
||||||
|
.IP
|
||||||
|
.ft 4
|
||||||
|
$ rpcgen \-n tcp \-o prot_svc.c prot.x
|
||||||
|
.ft 1
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
\f4cc\fP(1).
|
Loading…
Reference in New Issue
Block a user