-
Notifications
You must be signed in to change notification settings - Fork 78
Socket
Socket — Click element; a socket transport (user-level)
Socket("TCP", IP, PORTNUMBER [, LOCALIP] [, LOCALPORTNUMBER] [, KEYWORDS])
Socket("UDP", IP, PORTNUMBER [, LOCALIP] [, LOCALPORTNUMBER] [, KEYWORDS])
Socket("UNIX", FILENAME [, LOCALFILENAME] [, KEYWORDS])
Socket("UNIX_DGRAM", FILENAME [, LOCALFILENAME] [, KEYWORDS])
Ports: at most 1 input, at most 1 output
Drivers: userlevel
Transports packets over various types of sockets. Packets do not flow through Socket elements (i.e., Socket is an "x/y" element). Instead, input packets are sent to a remote host or process, and packets received from the remote host or process are emitted on the output.
A Socket element of type "TCP" or "UNIX" may be either a server (the default if CLIENT is not set) or a client (if CLIENT is set or if the element has no outputs). If a server, the specified address/port/file is bound and connections are accepted one at a time. If a client, a connection attempt is made to the specified address/port/file during element initialization.
A Socket element of type "UDP" or "UNIX_DGRAM" may also be either a server or client. However, because datagram sockets are not connection oriented, a datagram server may receive (and thus emit) packets from multiple remote hosts or processes. If a server, input packets are sent to the last remote host or process to send a packet to the server. If a client, input packets are sent to the specified address/port/file.
For convenience, if a client UDP Socket is configured with a zero IP address, the Socket will send input packets to the destination IP annotation of each packet.
If "LOCALIP"/"LOCALPORTNUMBER" or "LOCALFILENAME" is specified, CLIENT is assumed if not set and the specified local address/port/file will be bound before the connection attempt is made. If CLIENT is set to false, any "LOCALIP"/"LOCALPORTNUMBER" and "LOCALFILENAME" arguments are ignored.
Socket inputs are agnostic, i.e., they may be either "pull" or "push". If pushed, packets will block on the underlying socket; otherwise, the socket will pull packets as it can accept them. For best performance, place a Notifier element (such as NotifierQueue) upstream of a "pull" Socket.
Keyword arguments are:
-
SNAPLEN — Unsigned integer. Maximum length of packets that can be received. Default is 2048 bytes.
-
NODELAY — Boolean. Applies to TCP sockets only. If set, disable the Nagle algorithm. This means that segments are always sent as soon as possible, even if there is only a small amount of data. When not set, data is buffered until there is a sufficient amount to send out, thereby avoiding the frequent sending of small packets, which results in poor utilization of the network. Default is true.
-
CLIENT — Boolean. If set, forces the socket to connect() (if SOCK_STREAM) to the specified address/port (if AF_INET) or file handle (if AF_UNIX), instead of bind()-ing and listen()-ing to it.
Default is false. However, if a Socket element has no output and CLIENT is unspecified, it is assumed to be a client socket. If a Socket element has no input and CLIENT is unspecified, it is assumed to be a server socket.
-
SNDBUF — Unsigned integer. Sets the maximum size in bytes of the underlying socket send buffer. The default value is set by the wmem_default sysctl and the maximum allowed value is set by the wmem_max sysctl.
-
RCVBUF — Unsigned integer. Sets the maximum size in bytes of the underlying socket receive buffer. The default value is set by the rmem_default sysctl and the maximum allowed value is set by the rmem_max sysctl.
-
TIMESTAMP — Boolean. If set, sets the timestamp field on received packets to the current time. Default is true.
-
ALLOW — The name of an IPRouteTable element, like RadixIPLookup or DirectIPLookup. If set and the Socket element is a server, the Socket element will lookup source IP addresses of clients in the specified IPRouteTable before accepting a connection (if SOCK_STREAM) or datagram (if SOCK_DGRAM). If the address is found, the connection or datagram is accepted. If the address is not found, the DENY table will then be checked (see below).
-
DENY — The name of an IPRouteTable element, like RadixIPLookup or DirectIPLookup. If set and the Socket element is a server, the Socket element will lookup source IP addresses of clients in the specified IPRouteTable before accepting a connection (if SOCK_STREAM) or datagram (if SOCK_DGRAM). If the address is found, the connection or datagram is dropped, otherwise it is accepted. Note that the ALLOW table, if specified, is checked first. Wildcard matches may be specified with netmasks; for example, to deny all hosts, specify a route to "0.0.0.0/0" in the DENY table.
-
VERBOSE — Boolean. When true, Socket will print messages whenever it accepts a new connection or drops an old one. Default is false.
-
PROPER — Boolean. PlanetLab specific. If true and Click has been configured --with-proper, use Proper to bind a reserved port.
-
HEADROOM — Integer. Per-packet headroom. Defaults to 28.
// A server socket
Socket(TCP, 0.0.0.0, 80) -> ...
// A client socket
... -> Socket(TCP, 1.2.3.4, 80)
// A bi-directional server socket (handles one client at a time)
... -> Socket(TCP, 0.0.0.0, 80) -> ...
// A bi-directional client socket
... -> Socket(TCP, 1.2.3.4, 80, CLIENT true) -> ...
// A bi-directional client socket bound to a particular local port
... -> Socket(TCP, 1.2.3.4, 80, 0.0.0.0, 54321) -> ...
// A localhost server socket
allow :: RadixIPLookup(127.0.0.1 0);
deny :: RadixIPLookup(0.0.0.0/0 0);
allow -> deny -> allow; // (makes the configuration valid)
Socket(TCP, 0.0.0.0, 80, ALLOW allow, DENY deny) -> ...
Generated by click-elem2man from ../elements/userlevel/socket.hh:12 on 2018/10/03.