'\" t
.\"     Title: nn_shutdown
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2021-02-08
.\"    Manual: NNG Reference Manual
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "NN_SHUTDOWN" "3compat" "2021-02-08" "\ \&" "NNG Reference Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
nn_shutdown \- shut down endpoint (compatible API)
.SH "SYNOPSIS"
.sp
.if n .RS 4
.nf
.fam C
#include <nanomsg/nn.h>

int nn_shutdown(int sock, int ep)
.fam
.fi
.if n .RE
.SH "DESCRIPTION"
.sp
The \f(CRnn_shutdown()\fP shuts down the endpoint \fIep\fP, which is either a listener or
a dialer) on the socket \fIsock\fP.
This will stop the socket from either accepting new connections, or establishing
old ones.
Additionally, any established connections associated with \fIep\fP will be closed.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
This function is provided for API
compatibility with legacy \fIlibnanomsg\fP.
Consider using the relevant modern API instead.
.sp .5v
.RE
.SH "RETURN VALUES"
.sp
This function returns zero on success, and \-1 on error.
.SH "ERRORS"
.sp
\f(CREBADF\fP
.RS 4
The socket \fIsock\fP is not open.
.RE
.sp
\f(CREINVAL\fP
.RS 4
An invalid \fIep\fP was supplied.
.RE
.SH "SEE ALSO"
.sp
nn_bind(3compat),
nn_connect(3compat),
nn_errno(3compat),
nn_socket(3compat),
nn_compat(3compat),
nng(7)