class UNIXSocket

• UNIXSocket
• Socket
• IO
• Reference
• Object

Overview

A local interprocess communication clientsocket.

Only available on UNIX and UNIX-like operating systems.

Example usage:

require "socket"

sock = UNIXSocket.new("/tmp/myapp.sock")
sock.puts "message"
response = sock.gets
sock.close

Direct Known Subclasses

• UNIXServer

Defined in:

Constructors

• .new(path : String, type : Type = Type::STREAM)

  Connects a named UNIX socket, bound to a filesystem pathname.

• .new(*, fd : Handle, type : Type = Type::STREAM, path : String? = nil)

  Creates a UNIXSocket from an already configured raw file descriptor

Class Method Summary

• .open(path, type : Type = Type::STREAM, &)

  Opens an UNIX socket to a filesystem pathname, yields it to the block, then eventually closes the socket when the block returns.

• .pair(type : Type = Type::STREAM) : Tuple(UNIXSocket, UNIXSocket)

  Returns a pair of unnamed UNIX sockets.

• .pair(type : Type = Type::STREAM, &)

  Creates a pair of unnamed UNIX sockets (see .pair) and yields them to the block.

Instance Method Summary

• #local_address : Socket::UNIXAddress
• #path : String?
• #receive

  Receives a text message from the previously bound address.

• #remote_address : Socket::UNIXAddress

Constructor Detail

Class Method Detail

require "socket"

left, right = UNIXSocket.pair

spawn do
  # echo server
  message = right.gets
  right.puts message
end

left.puts "message"
left.gets # => "message"

Instance Method Detail

require "socket"

server = Socket.udp(Socket::Family::INET)
server.bind("localhost", 1234)

message, client_addr = server.receive