diff --git a/.cvsignore b/.cvsignore index e69de29..dbaf6e1 100644 --- a/.cvsignore +++ b/.cvsignore @@ -0,0 +1,3 @@ +man-pages-1.30.tar.bz2 +man2.tar.gz +netman-cvs.tar.gz diff --git a/man-pages.spec b/man-pages.spec new file mode 100644 index 0000000..3eae20b --- /dev/null +++ b/man-pages.spec @@ -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 +- fixed bad header specification (#15364) +- removed obsolete patches from package +- updated the rest + +* Wed Jul 12 2000 Prospector +- automatic rebuild + +* Mon Jun 19 2000 Matt Wilson +- defattr before docs in filelist + +* Sun Jun 17 2000 Trond Eivind Glomsrød +- updated to 1.30 + +* Tue Jun 06 2000 Trond Eivind Glomsrød +- use %%{_tmppath} + +* Wed May 31 2000 Trond Eivind Glomsrød +- remove resolv.conf(5) - part of bind-utils + +* Tue May 30 2000 Trond Eivind Glomsrød +- Remove resolver, dlclose, dlerror, dlopen, dlsym as these + are included in other packages. + +* Tue May 30 2000 Trond Eivind Glomsrød +- 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 +- updated to 1.29 +- split off other languages into separate RPMS + +* Thu Mar 16 2000 Florian La Roche +- do not use group "man" + +* Fri Mar 03 2000 Cristian Gafton +- don't apply the netman-cvs man pages anymore, as they seem to be really + out of date + +* Sat Feb 05 2000 Cristian Gafton +- put back man3/resolver.3 + +* Fri Feb 04 2000 Cristian Gafton +- remove non-man pages (#7814) + +* Fri Feb 4 2000 Matt Wilson +- exclude dir.1 and vdir.1 (these are in the fileutils package) + +* Thu Feb 03 2000 Cristian Gafton +- version 1.28 + +* Fri Nov 05 1999 Michael K. Johnson +- Fixed SIGILL, SIGQUIT in signals.7 + +* Wed Oct 06 1999 Cristian Gafton +- fox man page for getcwd + +* Wed Sep 22 1999 Cristian Gafton +- added man pages for set/getcontext + +* Tue Sep 14 1999 Bill Nottingham +- remove some bad man pages + +* Mon Sep 13 1999 Preston Brown +- czech, german, spanish, russian man pages + +* Thu Sep 09 1999 Cristian Gafton +- version 1.26 +- add french man pages +- add italian man pages + +* Fri Jul 23 1999 Jeff Johnson +- update to 1.25. + +* Fri Apr 16 1999 Cristian Gafton +- fiox man page fro ftw + +* Mon Apr 05 1999 Cristian Gafton +- spellnig fixse + +* Tue Mar 30 1999 Bill Nottingham +- updated to 1.23 + +* Thu Mar 25 1999 Cristian Gafton +- added kernel net manpages + +* Mon Mar 22 1999 Erik Troan +- updated printf man page +- added rpcgen man page + +* Sun Mar 21 1999 Cristian Gafton +- auto rebuild in the new build environment (release 6) + +* Thu Mar 18 1999 Cristian Gafton +- leave the lilo man pages alone (oops) + +* Fri Feb 12 1999 Michael Maher +- fixed bug #413 + +* Mon Jan 18 1999 Cristian Gafton +- remove lilo man pages too +- got rebuilt for 6.0 + +* Tue Sep 08 1998 Cristian Gafton +- version 1.21 + +* Sat Jun 20 1998 Jeff Johnson +- updated to 1.20 + +* Wed May 06 1998 Cristian Gafton +- get rid of the modutils man pages +- updated to 1.19 + +* Fri Apr 24 1998 Prospector System +- translations modified for de, fr, tr + +* Wed Apr 08 1998 Erik Troan +- updated to 1.18 + +* Sun Oct 19 1997 Erik Troan +- updated to 1.17 +- moved build root to /var + +* Thu Jul 31 1997 Erik Troan +- made a noarch package diff --git a/rpcgen.1 b/rpcgen.1 new file mode 100644 index 0000000..c51e5fb --- /dev/null +++ b/rpcgen.1 @@ -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). diff --git a/sources b/sources index e69de29..350af55 100644 --- a/sources +++ b/sources @@ -0,0 +1,3 @@ +ca763f081389063afc407347e667d6cd man-pages-1.30.tar.bz2 +af09d031dcee66929510e078d00066f2 man2.tar.gz +aaf374d3a727c70f6e05df9911f0ea01 netman-cvs.tar.gz