Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../.././../../../usr/man/man3c/sctp_getpaddrs.3c
Real path: /usr/share/man/man3c/sctp_getpaddrs.3c
Zurück
'\" te .\" Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved. .TH sctp_getpaddrs 3C "15 May 2014" "Oracle Solaris 11.4" "Standard C Library Functions" .SH NAME sctp_getpaddrs, sctp_freepaddrs \- returns all peer addresses on an SCTP association .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lsctp\fR [ \fIlibrary\fR... ] #include <sys/types.h> #include <sys/socket.h> #include <netinet/sctp.h> \fBint\fR \fBsctp_getpaddrs\fR(\fBint\fR \fIsock\fR, \fBsctp_assoc_t\fR \fIid\fR, \fBvoid **\fR\fIaddrs\fR); .fi .LP .nf \fBvoid\fR \fBsctp_freepaddrs\fR(\fBvoid *\fR\fIaddrs\fR); .fi .SH DESCRIPTION .sp .LP The \fBsctp_getpaddrs()\fR queries the peer addresses in an SCTP association. The \fBsctp_freepaddrs()\fR function releases resources that are allocated to hold the addresses. .sp .LP The \fBsctp_getpaddrs()\fR function returns all the peer addresses in the SCTP association identified by \fIsock\fR. On completion \fIaddrs\fR points to a dynamically allocated array of \fBsockaddr_in\fR structures for an Internet Protocol (IPv4) socket or an array of \fBsockaddr_in6\fR structures for an Internet Protocol Version 6 (IPv6) socket. The \fIaddrs\fR parameter must not be \fINULL\fR. For an IPv4 SCTP socket, the addresses returned in the \fBsockaddr_in\fR structures are IPv4 addresses. For an IPv6 SCTP socket, the addresses in the \fBsockaddr_in6\fR structures can be IPv6 addresses or IPv4-mapped IPv6 addresses. .sp .LP If \fIsock\fR is a one-to-many style SCTP socket, \fIid\fR specifies the association of interest. If \fIsock\fR is a one-to-one style SCTP socket, \fIid\fR is ignored. .sp .LP The \fBsctp_freepaddrs()\fR function frees the resources allocated by \fBsctp_getpaddrs()\fR. The \fIaddrs\fR parameter is the array of addresses allocated by \fBsctp_getpaddrs()\fR. .SH RETURN VALUES .sp .LP Upon successful completion, the \fBsctp_getpaddrs()\fR function returns the number of addresses in the \fIaddrs\fR array. Otherwise, the function returns \fB-1\fR and sets \fBerrno\fR to indicate the error. .SH ERRORS .sp .LP The \fBsctp_getpaddrs()\fR succeeds unless one of the following conditions exist. .sp .ne 2 .mk .na \fB\fBEBADF\fR\fR .ad .RS 12n .rt The \fIsock\fR argument is an invalid file descriptor. .RE .sp .ne 2 .mk .na \fB\fBENOTSOCK\fR\fR .ad .RS 12n .rt The \fIsock\fR argument is not a socket. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 12n .rt The \fIaddrs\fR argument is \fINULL\fR. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 12n .rt The \fIid\fR argument is an invalid association identifier for a one-to-many style STP socket. .RE .sp .ne 2 .mk .na \fB\fBENOTCONN\fR\fR .ad .RS 12n .rt The specified socket is not connected. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level Safe .TE .sp .SH SEE ALSO .sp .LP \fBbind\fR(3C), \fBsctp_freeladdrs\fR(3C), \fBsctp_getladdrs\fR(3C), \fBsocket\fR(3C), \fBin.h\fR(3HEAD), \fBlibsctp\fR(3LIB), \fBinet\fR(4P), \fBinet6\fR(4P), \fBip\fR(4P), \fBip6\fR(4P), \fBsctp\fR(4P), \fBattributes\fR(7)