~ubuntu-branches/ubuntu/saucy/zeromq3/saucy

The \fIendpoint\fR argument is a string consisting of two parts as follows: \fItransport\fR://\fIaddress\fR\&. The \fItransport\fR part specifies the underlying transport protocol to use\&. The meaning of the \fIaddress\fR part is specific to the underlying transport protocol selected\&.

.sp

The following transports are defined:

.PP

\fIinproc\fR

.RS 4

local in\-process (inter\-thread) communication transport, see

\fBzmq_inproc\fR(7)

.RE

.PP

\fIipc\fR

.RS 4

local inter\-process communication transport, see

\fBzmq_ipc\fR(7)

.RE

.PP

\fItcp\fR

.RS 4

unicast transport using TCP, see

\fBzmq_tcp\fR(7)

.RE

.PP

\fIpgm\fR, \fIepgm\fR

.RS 4

reliable multicast transport using PGM, see

\fBzmq_pgm\fR(7)

.RE

.sp

With the exception of \fIZMQ_PAIR\fR sockets, a single socket may be connected to multiple endpoints using \fIzmq_connect()\fR, while simultaneously accepting incoming connections from multiple endpoints bound to the socket using \fIzmq_bind()\fR\&. Refer to \fBzmq_socket\fR(3) for a description of the exact semantics involved when connecting or binding a socket to multiple endpoints\&.

.SH "RETURN VALUE"

.sp

The \fIzmq_bind()\fR function shall return zero if successful\&. Otherwise it shall return \-1 and set \fIerrno\fR to one of the values defined below\&.

.SH "ERRORS"

.PP

\fBEINVAL\fR

.RS 4

The endpoint supplied is invalid\&.

.RE

.PP

\fBEPROTONOSUPPORT\fR

.RS 4

The requested

\fItransport\fR

protocol is not supported\&.

.RE

.PP

\fBENOCOMPATPROTO\fR

.RS 4

The requested

\fItransport\fR

protocol is not compatible with the socket type\&.

.RE

.PP

\fBEADDRINUSE\fR

.RS 4

The requested

\fIaddress\fR

is already in use\&.

.RE

.PP

\fBEADDRNOTAVAIL\fR

100

.RS 4

101

The requested

102

\fIaddress\fR

103

was not local\&.

104

.RE

105

.PP

106

\fBENODEV\fR

107

.RS 4

108

The requested

109

\fIaddress\fR

110

specifies a nonexistent interface\&.

111

.RE

112

.PP

113

\fBETERM\fR

114

.RS 4

115

The 0MQ

116

\fIcontext\fR

117

associated with the specified

118

\fIsocket\fR

119

was terminated\&.

120

.RE

121

.PP

122

\fBENOTSOCK\fR

123

.RS 4

124

The provided

125

\fIsocket\fR

126

was invalid\&.

127

.RE

128

.PP

129

\fBEMTHREAD\fR

130

.RS 4

131

No I/O thread is available to accomplish the task\&.

132

.RE

133

.SH "EXAMPLE"

134

.PP

135

\fBBinding a publisher socket to an in-process and a TCP transport\fR.

136

.sp

137

.if n \{\

138

.RS 4

139

.\}

140

.nf

141

/* Create a ZMQ_PUB socket */

142

void *socket = zmq_socket (context, ZMQ_PUB);

143

assert (socket);

144

/* Bind it to a in\-process transport with the address \*(Aqmy_publisher\*(Aq */

145

int rc = zmq_bind (socket, "inproc://my_publisher");

146

assert (rc == 0);

147

/* Bind it to a TCP transport on port 5555 of the \*(Aqeth0\*(Aq interface */

148

rc = zmq_bind (socket, "tcp://eth0:5555");

149

assert (rc == 0);

150

.fi

151

.if n \{\

152

.RE

153

.\}

154

.sp

155

.SH "SEE ALSO"

156

.sp

157

\fBzmq_connect\fR(3) \fBzmq_socket\fR(3) \fBzmq\fR(7)

158

.SH "AUTHORS"

159

.sp

160

The 0MQ documentation was written by Martin Sustrik <\m[blue]\fBsustrik@250bpm\&.com\fR\m[]\&\s-2\u[1]\d\s+2> and Martin Lucina <\m[blue]\fBmartin@lucina\&.net\fR\m[]\&\s-2\u[2]\d\s+2>\&.

161

.SH "NOTES"

162

.IP " 1." 4

163

sustrik@250bpm.com

164

.RS 4

165

\%mailto:sustrik@250bpm.com

166

.RE

167

.IP " 2." 4

168

martin@lucina.net

169

.RS 4

170

\%mailto:martin@lucina.net

171

.RE

Older »