2019-07-27 15:29:27 +02:00
|
|
|
|
|
|
|
@[Link("ipc")]
|
|
|
|
lib LibIPC
|
|
|
|
struct Connection
|
|
|
|
type : UInt8
|
|
|
|
spath : LibC::Char* # [4096] # [PATH_MAX]
|
|
|
|
end
|
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
struct Pollfd
|
|
|
|
fd : LibC::Int
|
|
|
|
events : LibC::Short
|
|
|
|
revents : LibC::Short
|
|
|
|
end
|
|
|
|
|
|
|
|
struct Ctx
|
|
|
|
cinfos : Connection*
|
|
|
|
pollfd : Pollfd*
|
|
|
|
tx : Messages
|
2020-07-02 22:29:35 +02:00
|
|
|
size : LibC::UInt64T
|
2019-07-27 15:29:27 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
struct Switching
|
|
|
|
origin : LibC::Int
|
|
|
|
dest : LibC::Int
|
|
|
|
end
|
|
|
|
|
|
|
|
struct Switchings
|
|
|
|
collection : Switching*
|
|
|
|
size : LibC::UInt
|
|
|
|
end
|
|
|
|
|
|
|
|
enum MessageType
|
|
|
|
ServerClose
|
|
|
|
Error
|
|
|
|
Data
|
|
|
|
LookUp
|
|
|
|
end
|
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Messages are stored in lists within the libipc before being sent.
|
|
|
|
struct Messages
|
|
|
|
messages : Message*
|
2020-07-02 22:29:35 +02:00
|
|
|
size : LibC::UInt64T
|
2020-07-01 16:24:13 +02:00
|
|
|
end
|
|
|
|
|
2019-07-27 15:29:27 +02:00
|
|
|
struct Message
|
2020-07-01 16:24:13 +02:00
|
|
|
type : UInt8 # Internal message type.
|
|
|
|
user_type : UInt8 # User-defined message type.
|
|
|
|
fd : LibC::Int # fd of the sender.
|
|
|
|
length : LibC::UInt # Payload length.
|
|
|
|
payload : LibC::Char* #
|
2019-07-27 15:29:27 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
enum EventType
|
2020-07-02 21:13:54 +02:00
|
|
|
NotSet #
|
|
|
|
Error #
|
|
|
|
ExtraSocket # Message received from a non IPC socket.
|
|
|
|
Switch # Message to send to a corresponding fd.
|
|
|
|
Connection # New user.
|
|
|
|
Disconnection # User disconnected.
|
|
|
|
Message # New message.
|
|
|
|
LookUp # Client asking for a service through ipcd.
|
|
|
|
Timer # Timeout in the poll(2) function.
|
|
|
|
Tx # Message sent.
|
2019-07-27 15:29:27 +02:00
|
|
|
end
|
|
|
|
|
|
|
|
struct Event
|
2020-07-01 16:24:13 +02:00
|
|
|
type : EventType #
|
|
|
|
index : LibC::UInt # Index of the sender in the ipc_ctx structure.
|
|
|
|
origin : LibC::Int # fd of the sender.
|
|
|
|
message : Message* # Pointer to the reveiced message.
|
2019-07-27 15:29:27 +02:00
|
|
|
end
|
|
|
|
|
2020-01-01 14:29:05 +01:00
|
|
|
struct IPCError
|
|
|
|
# This is the size of an enumeration in C.
|
|
|
|
error_code : UInt32
|
|
|
|
error_message : LibC::Char[8192]
|
|
|
|
end
|
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Connection functions.
|
|
|
|
# Context is allocated, ipcd is requested and the connection/initialisation is performed.
|
|
|
|
fun ipc_server_init(ctx : Ctx*, sname : LibC::Char*) : IPCError
|
|
|
|
fun ipc_connection(Ctx*, LibC::Char*) : IPCError
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Closing connections.
|
2020-07-02 22:29:35 +02:00
|
|
|
fun ipc_close(ctx : Ctx*, index : LibC::UInt64T) : IPCError
|
2020-07-01 16:24:13 +02:00
|
|
|
fun ipc_close_all(ctx : Ctx*) # Void
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
fun ipc_ctx_free(Ctx*) # Void
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Loop function.
|
|
|
|
fun ipc_events_loop(Ctx*, Event*, LibC::UInt*) : IPCError
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Adding and removing file discriptors to read.
|
|
|
|
fun ipc_add(Ctx*, Connection*, Pollfd*) : IPCError
|
|
|
|
fun ipc_del(Ctx*, LibC::UInt) : IPCError
|
|
|
|
fun ipc_add_fd(Ctx*, LibC::Int) : IPCError
|
|
|
|
fun ipc_del_fd(Ctx*, LibC::Int) : IPCError
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# Sending a message (will wait the fd to become available for IO operations).
|
|
|
|
fun ipc_write(Ctx*, Message*) : IPCError
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-01-01 14:29:05 +01:00
|
|
|
# This function let the user get the default error message based on the error code.
|
|
|
|
# The error message is contained in the IPCError structure, this function should not be used, in most cases.
|
2019-07-27 15:29:27 +02:00
|
|
|
fun ipc_errors_get (LibC::Int) : LibC::Char*
|
|
|
|
|
2020-01-01 14:29:05 +01:00
|
|
|
fun ipc_receive_fd (sock : LibC::Int, fd : LibC::Int*) : IPCError
|
|
|
|
fun ipc_provide_fd (sock : LibC::Int, fd : LibC::Int ) : IPCError
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-01-01 14:29:05 +01:00
|
|
|
fun ipc_switching_add (switch : Switchings*, fd1 : LibC::Int, fd2 : LibC::Int) # Void
|
|
|
|
fun ipc_switching_del (switch : Switchings*, fd : LibC::Int ) : LibC::Int
|
|
|
|
fun ipc_switching_get (switch : Switchings*, fd : LibC::Int ) : LibC::Int
|
|
|
|
fun ipc_switching_free (switch : Switchings* ) # Void
|
2019-07-27 15:29:27 +02:00
|
|
|
|
2020-07-01 16:24:13 +02:00
|
|
|
# non public functions
|
2020-07-02 21:48:17 +02:00
|
|
|
fun ipc_read(ctx : Ctx*, index : LibC::UInt, message : Message*) : IPCError
|
2020-07-01 16:24:13 +02:00
|
|
|
|
|
|
|
# for testing purposes
|
2020-01-01 14:29:05 +01:00
|
|
|
fun ipc_switching_print (switch : Switchings*) # Void
|
|
|
|
fun service_path (path : LibC::Char*, sname : LibC::Char*, index : Int32, version : Int32) : IPCError
|
2020-07-02 22:30:40 +02:00
|
|
|
fun ipc_ctx_print (Ctx*) # Void
|
2019-07-27 15:29:27 +02:00
|
|
|
end
|