summaryrefslogtreecommitdiffstats
path: root/man3/getrpcport.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/getrpcport.3')
-rw-r--r--man3/getrpcport.360
1 files changed, 60 insertions, 0 deletions
diff --git a/man3/getrpcport.3 b/man3/getrpcport.3
new file mode 100644
index 0000000..56b6188
--- /dev/null
+++ b/man3/getrpcport.3
@@ -0,0 +1,60 @@
+'\" t
+.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
+.\"
+.\" %%%LICENSE_START(BSD_ONELINE_CDROM)
+.\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
+.\" %%%LICENSE_END
+.\"
+.\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI
+.TH getrpcport 3 2023-07-20 "Linux man-pages 6.05.01"
+.SH NAME
+getrpcport \- get RPC port number
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
+.SH SYNOPSIS
+.nf
+.B "#include <rpc/rpc.h>"
+.PP
+.BI "int getrpcport(const char *" host ", unsigned long " prognum ,
+.BI " unsigned long " versnum ", unsigned int " proto );
+.fi
+.SH DESCRIPTION
+.BR getrpcport ()
+returns the port number for version
+.I versnum
+of the RPC program
+.I prognum
+running on
+.I host
+and using protocol
+.IR proto .
+It returns 0 if it cannot contact the portmapper, or if
+.I prognum
+is not registered.
+If
+.I prognum
+is registered but not with version
+.IR versnum ,
+it will still return a port number (for some version of the program)
+indicating that the program is indeed registered.
+The version mismatch will be detected upon the first call to the service.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lbx lb lb
+l l l.
+Interface Attribute Value
+T{
+.na
+.nh
+.BR getrpcport ()
+T} Thread safety MT-Safe env locale
+.TE
+.sp 1
+.SH STANDARDS
+BSD.
+.SH HISTORY
+BSD, Solaris.