Constants

• EPOLL_CTL_ADD, EPOLL_CTL_DEL, and EPOLL_CTL_MOD: epoll control operations.
• EPOLLIN, EPOLLOUT, and EPOLLONESHOT: epoll event flags.
• TFD_NONBLOCK: nonblocking timerfd flag.

Constant example

"linux/linux" use
"control" use

{} () {} [
  EPOLL_CTL_ADD printStack _:;
  EPOLLIN printStack _:;
  TFD_NONBLOCK printStack _:;
] "main" exportFunction

Expected Output During Compilation

1
1n32
2048

Schemas

• epoll_event: event record with events and two-word private storage.
• epoll_event also exposes helper accessors ptr, fd, u32, u64, and item for interpreting that same private storage.
• timerfd_settime uses itimerspec for timer configuration.

Schema example

"linux/linux" use
"control" use

{} () {} [
  epoll_event fieldCount printStack _:;
  epoll_event 1 fieldName printStack _:;
] "main" exportFunction

Expected Output During Compilation

7
"data"

epoll and timer model

• epoll_event stores one two-word private area together with readiness flags.
• ptr, fd, u32, and u64 reinterpret that stored value without changing the underlying bytes.
• item interprets the stored value as an object address and returns a typed reference view. If the source epoll_event value is const, item returns one const reference view of that stored address.
• timerfd_create creates one timer descriptor for the selected clock, and timerfd_settime applies one itimerspec value and can also report the previous timer state.

Arguments and results

• epoll_ctl.event is one borrowed epoll_event record passed by reference.
• epoll_wait.events is one raw address of contiguous epoll_event storage, and maxevents is the available record capacity.
• timerfd_settime.new_value and timerfd_settime.old_value are caller-owned writable or borrowed itimerspec pointers.
• epoll_create1 and timerfd_create report their result through the returned descriptor value.
• epoll_ctl and timerfd_settime return Int32 status results.
• epoll_wait returns one Int32 event-count result.
• Returned descriptors are released with close when they are no longer needed.
• epoll_ctl, epoll_wait, and timerfd_settime do not transfer descriptor ownership.
• epoll_event and itimerspec storage remain caller-owned.
• Error-number access for failing calls is provided separately.

Imported functions

• epoll_create1: creates one epoll descriptor.
• epoll_ctl: adds, removes, or modifies one watched descriptor.
• epoll_wait: waits for ready epoll events.
• timerfd_create: creates one timer descriptor.
• timerfd_settime: configures timer intervals and expiration state.

Signature examples

Printing imported names during compilation shows exact imported signatures for representative declarations.

"linux/linux" use
"control" use

{} Int32 {} [
  @epoll_wait printStack _:;
  @timerfd_settime printStack _:;
  0
] "main" exportFunction

Expected Output During Compilation

{epfd: Int32; events: Natx; maxevents: Int32; timeout: Int32;} Int32 {convention: "";} codeRef
{fd: Int32; flags: Int32; new_value: {it_interval: {tv_sec: Intx; tv_nsec: Intx;}; it_value: {tv_sec: Intx; tv_nsec: Intx;};} Cref; old_value: {it_interval: {tv_sec: Intx; tv_nsec: Intx;}; it_value: {tv_sec: Intx; tv_nsec: Intx;};} Ref;} Int32 {convention: "";} codeRef

Examples

epoll descriptor creation

"linux/linux" use
"linux/posix" use
"String" use
"control" use

{} Int32 {} [
  epfd: 0 epoll_create1;
  epClose: epfd close;
  ("created=" epfd 0 < ~ LF
   "close=" epClose 0 = LF) printList
  0
] "main" exportFunction

Expected Output

created=TRUE
close=TRUE

Timer descriptor creation

"linux/linux" use
"linux/posix" use
"String" use
"control" use

{} Int32 {} [
  fd: CLOCK_MONOTONIC TFD_NONBLOCK timerfd_create;
  closeResult: fd close;
  ("created=" fd 0 < ~ LF
   "close=" closeResult 0 = LF) printList
  0
] "main" exportFunction

Expected Output

created=TRUE
close=TRUE

See also

• linux/errno · macos/errno · windows/errno: Accessor for platform error-number storage.
• linux/posix: POSIX process, timing, descriptor, and context declarations used by Linux support modules.
• linux/runningTime · windows/runningTime: Elapsed-time helper built on platform timing APIs.
• sync/sync: Cross-platform scheduling, sleep, time, IPv4 formatting, and TCP helpers.
• linux/socket: Linux socket declarations, constants, address schemas, and imported functions.