URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [packages/] [net/] [tcpip/] [v2_0/] [doc/] [bind.html] - Blame information for rev 592

Go to most recent revision | Details | Compare with Previous | View Log


<html>
<body>
<pre>
NAME
       bind - bind a name to a socket
 
SYNOPSIS
       #include &lt;network.h&gt;
 
       int   bind(int   sockfd,  struct  sockaddr  *my_addr,  int
       addrlen);
 
DESCRIPTION
       bind gives the socket sockfd the  local  address  my_addr.
       my_addr  is  addrlen  bytes  long.  Traditionally, this is
       called "assigning a name to a socket."  (When a socket  is
       created with socket(2), it exists in a name space (address
       family) but has no name assigned.)
 
       Before a SOCK_STREAM socket is put into the  LISTEN  state
       to receive connections, you usually need to first assign a
       local address using bind to make the socket visible.
 
NOTES
       Binding a name that is not in the  abstract  namespace  in
       the  UNIX  domain creates a socket in the file system that
       must be deleted by the caller when it is no longer  needed
       (using unlink(2)).
 
       The  rules used in name binding vary between communication
       domains.  Consult the manual  entries  in  section  4  for
       detailed information. For IP see ip(4) and for PF_UNIX see
       unix(4).  If you want to listen to every  local  interface
       for  IPv4 set the sin_addr member of the IP-specific sock-
       addr_in to INADDR_ANY.  For IP  only  one  socket  may  be
       bound  to  a  specific  local address/port pair. For TCP a
       bound  local  socket  endpoint  (address/port   pair)   is
       unavailable for some time after closing the socket, unless
       the SO_REUSEADDR flag is set. Note that carelessly setting
       SO_REUSEADDR might make TCP more unreliable unless PAWS is
       used (see tcp(4)); the delay is needed to handle old pack-
       ets still in the network.
 
       IP  sockets  may  also  bind  to  a broadcast or multicast
       address.
 
RETURN VALUE
       On success, zero is returned.  On error, -1  is  returned,
       and errno is set appropriately.
 
ERRORS
       EBADF   sockfd is not a valid descriptor.
 
       EINVAL  The  socket  is already bound to an address.  This
               may change in the  future:  see  linux/unix/sock.c
               for details.
 
       ENOTSOCK
               Argument is a descriptor for a file, not a socket.
 
 
</pre>
</body>
</html>

Line No.	Rev	Author	Line
1	27	unneback	`<html>`
2			`<body>`
3			`<pre>`
4			`NAME`
5			`bind - bind a name to a socket`
6
7			`SYNOPSIS`
8			`#include <network.h>`
9
10			`int bind(int sockfd, struct sockaddr *my_addr, int`
11			`addrlen);`
12
13			`DESCRIPTION`
14			`bind gives the socket sockfd the local address my_addr.`
15			`my_addr is addrlen bytes long. Traditionally, this is`
16			`called "assigning a name to a socket." (When a socket is`
17			`created with socket(2), it exists in a name space (address`
18			`family) but has no name assigned.)`
19
20			`Before a SOCK_STREAM socket is put into the LISTEN state`
21			`to receive connections, you usually need to first assign a`
22			`local address using bind to make the socket visible.`
23
24			`NOTES`
25			`Binding a name that is not in the abstract namespace in`
26			`the UNIX domain creates a socket in the file system that`
27			`must be deleted by the caller when it is no longer needed`
28			`(using unlink(2)).`
29
30			`The rules used in name binding vary between communication`
31			`domains. Consult the manual entries in section 4 for`
32			`detailed information. For IP see ip(4) and for PF_UNIX see`
33			`unix(4). If you want to listen to every local interface`
34			`for IPv4 set the sin_addr member of the IP-specific sock-`
35			`addr_in to INADDR_ANY. For IP only one socket may be`
36			`bound to a specific local address/port pair. For TCP a`
37			`bound local socket endpoint (address/port pair) is`
38			`unavailable for some time after closing the socket, unless`
39			`the SO_REUSEADDR flag is set. Note that carelessly setting`
40			`SO_REUSEADDR might make TCP more unreliable unless PAWS is`
41			`used (see tcp(4)); the delay is needed to handle old pack-`
42			`ets still in the network.`
43
44			`IP sockets may also bind to a broadcast or multicast`
45			`address.`
46
47			`RETURN VALUE`
48			`On success, zero is returned. On error, -1 is returned,`
49			`and errno is set appropriately.`
50
51			`ERRORS`
52			`EBADF sockfd is not a valid descriptor.`
53
54			`EINVAL The socket is already bound to an address. This`
55			`may change in the future: see linux/unix/sock.c`
56			`for details.`
57
58			`ENOTSOCK`
59			`Argument is a descriptor for a file, not a socket.`
60
61
62			`</pre>`
63			`</body>`
64			`</html>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [packages/] [net/] [tcpip/] [v2_0/] [doc/] [bind.html] - Blame information for rev 592