File: socket_broadcast.3

package info (click to toggle)
libowfat 0.34-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,288 kB
  • sloc: ansic: 20,181; makefile: 16
file content (29 lines) | stat: -rw-r--r-- 801 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
.TH socket_broadcast 3
.SH NAME
socket_broadcast \- set UDP socket to broadcast mode
.SH SYNTAX
.B #include <libowfat/socket.h>

int \fBsocket_broadcast\fP(int \fIs\fR);
.SH DESCRIPTION
socket_broadcast sets UDP socket \fIs\fR to broadcast mode.
socket_send4 and socket_send6 will fail to send packets to the broadcast
address unless socket_broadcast is called before.

Normally socket_broadcast returns 0.

If anything goes wrong, socket_broadcast returns -1, setting errno
appropriately.

.SH EXAMPLE
  #include <libowfat/socket.h>

  int \fIs\fR;

  if ((\fIs\fR=socket_udp6())==-1)
    strerr_die2sys(111,FATAL,"unable to create UDP socket: ");
  if (socket_broadcast(\fIs\fR) == -1)
    strerr_die2sys(111,FATAL,"unable to set broadcast mode: ");

.SH "SEE ALSO"
socket_send4(3), socket_send6(3)