Files
Odin/core/sys/linux/sys.odin
2023-11-01 10:06:30 +11:00

2040 lines
59 KiB
Odin

//+build linux
package linux
import "core:intrinsics"
/// Read data from file into the buffer
/// Returns the number of bytes successfully read, which may be less than the size
/// of the buffer even if the termination is successfull
///
/// Available since Linux 1.0
/// Before Linux 3.14, this operation is not atomic (i.e. not thread safe).
read :: proc "contextless" (fd: Fd, buf: []$T) -> (int, Errno) {
ret := syscall(SYS_read, fd, raw_data(buf), len(buf) * size_of(T))
return errno_unwrap(ret, int)
}
/// Write the data from a buffer into the file
/// Returns the number of bytes successfully written, which may be less than the size
/// of the buffer, even if the termination is successfull
/// When using direct I/O, error doesn't mean the write has failed. Partial data may
/// have been written.
/// If .Eintr is returned, the write operation has failed due to interrupt. You'll probably
/// need to restart this syscall
///
/// Available since Linux 1.0
/// Before Linux 3.14 this operation is not atomic (i.e. not thread safe)
write :: proc "contextless" (fd: Fd, buf: []$T) -> (int, Errno) {
ret := syscall(SYS_write, fd, raw_data(buf), len(buf)*size_of(T))
return errno_unwrap(ret, int)
}
/// Open file, get the file descriptor
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
open :: proc "contextless" (name: cstring, flags: Open_Flags, mode: Mode = {}) -> (Fd, Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_openat, AT_FDCWD, transmute(uintptr) name, transmute(u32) mode)
return errno_unwrap(ret, Fd)
} else {
ret := syscall(SYS_open, transmute(uintptr) name, transmute(u32) mode)
return errno_unwrap(ret, Fd)
}
}
/// Close the file
/// Available since Linux 1.0
close :: proc "contextless" (fd: Fd) -> (Errno) {
ret := syscall(SYS_close, fd)
return Errno(-ret)
}
/// Get file status
///
/// Returns information about the file in struct pointed to by `stat` parameter.
///
/// Available since Linux 1.0
/// For 32-bit systems a different syscall is used that became available since 2.4
/// Not available on arm64
stat :: proc "contextless" (filename: cstring, stat: ^Stat) -> (Errno) {
when size_of(int) == 8 {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_fstatat, AT_FDCWD, cast(rawptr) filename, stat)
return Errno(-ret)
} else {
ret := syscall(SYS_stat, cast(rawptr) filename, stat)
return Errno(-ret)
}
} else {
ret := syscall(SYS_stat64, cast(rawptr) filename, stat)
return Errno(-ret)
}
}
/// Get file status from file descriptor
///
/// Returns information about the file in struct pointed to by `stat` parameter.
///
/// Available since Linux 1.0
/// For 32-bit systems a different syscall is used that became available since 2.4
fstat :: proc "contextless" (fd: Fd, stat: ^Stat) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_fstat, stat)
return Errno(-ret)
} else {
ret := syscall(SYS_fstat64, stat)
return Errno(-ret)
}
}
/// Get information about the file that's potentially a symbolic link
/// The information is returned in a struct pointed to by `stat` parameter.
/// The difference with stat, fstat is that if the file is a symbolic link,
/// stat and fstat will dereference the link. lstat doesn't dereference symlinks
///
/// Available since Linux 1.0
/// For 32-bit systems a different syscall is used that became available since 2.4
/// Not available on arm64
lstat :: proc "contextless" (filename: cstring, stat: ^Stat) -> (Errno) {
when size_of(int) == 8 {
when ODIN_ARCH == .arm64 {
return fstatat(AT_FDCWD, filename, stat, {.SYMLINK_NOFOLLOW})
} else {
ret := syscall(SYS_lstat, cast(rawptr) filename, stat)
return Errno(-ret)
}
} else {
ret := syscall(SYS_lstat64, cast(rawptr) filename, stat)
return Errno(-ret)
}
}
/// Wait on event on a file descriptor
/// Available since Linux 2.2
poll :: proc "contextless" (fds: []Poll_Fd, timeout: i32) -> (i32, Errno) {
when ODIN_ARCH == .arm64 {
seconds := cast(uint) timeout / 1000
nanoseconds := cast(uint) (timeout % 1000) * 1_000_000
timeout_spec := Time_Spec{seconds, nanoseconds}
ret := syscall(SYS_ppoll, raw_data(fds), len(fds), &timeout_spec, 0, 0)
return errno_unwrap(ret, i32)
} else {
ret := syscall(SYS_poll, raw_data(fds), len(fds), timeout)
return errno_unwrap(ret, i32)
}
}
/// Seek the file stream to specified offset
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 1.2
lseek :: proc "contextless" (fd: Fd, off: i64, whence: Seek_Whence) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_lseek, fd, off, whence)
return Errno(-ret)
} else {
ret := syscall(SYS__llseek, fd, compat64_arg_pair(off), whence)
return Errno(-ret)
}
}
/// Map files into memory
/// Available since Linux 1.0
/// On 32-bit platforms since Linux 1.0
mmap :: proc "contextless" (addr: uintptr, size: uint, prot: Mem_Protection, flags: Map_Flags, fd: Fd = Fd(-1), offset: i64 = 0) -> (rawptr, Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_mmap, addr, size, transmute(i32) prot, transmute(i32) flags, fd, offset)
return errno_unwrap(ret, rawptr, uintptr)
} else {
ret := syscall(SYS_mmap2, addr, size, transmute(i32) prot, transmute(i32) flags, fd, cast(uintptr)(offset/4096))
return errno_unwrap(ret, rawptr, uintptr)
}
}
/// Protect memory region
mprotect :: proc "contextless" (addr: rawptr, size: uint, prot: Mem_Protection) -> (Errno) {
ret := syscall(SYS_mprotect, addr, size, transmute(i32) prot)
return Errno(-ret)
}
/// Unmap memory
/// Available since Linux 1.0
munmap :: proc "contextless" (addr: rawptr, size: uint) -> (Errno) {
ret := syscall(SYS_mmap, addr, size)
return Errno(-ret)
}
// TODO(flysand): brk
/// Alter an action taken by a process
rt_sigaction :: proc "contextless" (sig: Signal, sigaction: ^Sig_Action, old_sigaction: ^Sig_Action) -> Errno {
ret := syscall(SYS_rt_sigaction, sig, sigaction, old_sigaction, size_of(Sig_Set))
return Errno(-ret)
}
/// Examime and alter blocked signals
/// Available since Linux 2.2
rt_sigprocmask :: proc "contextless" (mask_kind: Sig_Mask_Kind, new_set: ^Sig_Set, old_set: ^Sig_Set) -> Errno {
ret := syscall(SYS_rt_sigprocmask, mask_kind, new_set, old_set, size_of(Sig_Set))
return Errno(-ret)
}
// TODO(flysand): rt_sigreturn
// TODO(flysand): ioctl
/// Read the file at a specified offset
/// Note, it is not an error to return less bytes than requested
/// Available since Linux 2.2
pread :: proc "contextless" (fd: Fd, buf: []$T, offset: i64) -> (int, Errno) {
ret := syscall(SYS_pread64, fd, raw_data(buf), compat64_arg_pair(len(buf)*size_of(T)))
return errno_unwrap(ret, int)
}
/// Read the file at a specified offset
/// Note, it is not an error to return less bytes than requested
/// Available since Linux 2.2
pwrite :: proc "contextless" (fd: Fd, buf: []$T, offset: i64) -> (int, Errno) {
ret := syscall(SYS_pwrite64, fd, raw_data(buf), compat64_arg_pair(len(buf)*size_of(T)))
return errno_unwrap(ret, int)
}
// TODO(flysand): readv
// TODO(flysand): writev
/// Check user permissions for a file
/// If Mode is F_OK, checks whether the file exists
/// Similarly, X_OK, W_OK, R_OK check if the file is executable, writeable, readable respectively
/// Available since Linux 1.0
/// For ARM64 available since Linux 2.6.16
access :: proc "contextless" (name: cstring, mode: Mode = F_OK) -> (bool, Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_faccessat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode)
return errno_unwrap(ret, bool)
} else {
ret := syscall(SYS_access, cast(rawptr) name, transmute(u32) mode)
return errno_unwrap(ret, bool)
}
}
/// Create a pipe
/// Available since Linux 2.6.27
pipe2 :: proc "contextless" (pipes: ^[2]Fd, flags: Open_Flags) -> (Errno) {
ret := syscall(SYS_pipe2, pipes, transmute(u32) flags)
return Errno(-ret)
}
// TODO(flysand): select
// TODO(flysand): sched_yield
// TODO(flysand): add docs here
mremap :: proc "contextless" (old_addr: rawptr, old_size: uint, new_size: uint, flags: MRemap_Flags, new_addr: uintptr = 0) -> (rawptr, Errno) {
if .FIXED in flags {
ret := syscall(SYS_mremap, old_addr, old_size, new_size, transmute(i32) flags, new_addr)
return errno_unwrap(ret, rawptr, rawptr)
} else {
ret := syscall(SYS_mremap, old_addr, old_size, new_size, transmute(i32) flags)
return errno_unwrap(ret, rawptr, rawptr)
}
}
/// Sync file with memory map
/// Available since Linux 2.0
msync :: proc "contextless" (addr: rawptr, size: uint, flags: MSync_Flags) -> (Errno) {
ret := syscall(SYS_msync, addr, size, transmute(i32) flags)
return Errno(-ret)
}
// TODO(flysand): mincore
/// Give advice about use of memory
/// Available since Linux 2.4
madvise :: proc "contextless" (addr: rawptr, size: uint, advice: MAdvice) -> (Errno) {
ret := syscall(SYS_madvise, addr, size, advice)
return Errno(-ret)
}
// TODO(flysand): shmget
// TODO(flysand): shmat
// TODO(flysand): shmctl
/// Allocate a new file descriptor that refers to the same file as the one provided
/// Available since Linux 1.0
dup :: proc "contextless" (fd: Fd) -> (Fd, Errno) {
ret := syscall(SYS_dup, fd)
return errno_unwrap(ret, Fd)
}
/// Adjust an existing file descriptor to point to the same file as `old`
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.27
dup2 :: proc "contextless" (old: Fd, new: Fd) -> (Fd, Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_dup3, old, new, 0)
return errno_unwrap(ret, Fd)
} else {
ret := syscall(SYS_dup2, old, new)
return errno_unwrap(ret, Fd)
}
}
// TODO(flysand): pause
// TODO(flysand): nanosleep
// TODO(flysand): getitimer
// TODO(flysand): alarm
// TODO(flysand): setitimer
/// Returns the thread group ID of the current process
/// Note that it doesn't return the pid, despite it's name.
/// Available since Linux 1.0
getpid :: proc "contextless" () -> Pid {
return cast(Pid) syscall(SYS_getpid)
}
// TODO(flysand): sendfile
/// Create a socket file descriptor
/// Available since Linux 2.0
socket :: proc "contextless" (domain: Address_Family, socktype: Socket_Type, sockflags: Socket_FD_Flags, protocol: Protocol) -> (Fd, Errno) {
sock_type_flags: int = cast(int) socktype | transmute(int) sockflags
ret := syscall(SYS_socket, domain, sock_type_flags, protocol)
return errno_unwrap(ret, Fd)
}
/// Connect the socket to the address
/// Available since Linux 2.0
connect :: proc "contextless" (sock: Fd, addr: ^$T) -> (Errno)
where
T == Sock_Addr_In ||
T == Sock_Addr_In6 ||
T == Sock_Addr_Any
{
ret := syscall(SYS_connect, sock, addr, size_of(T))
return Errno(-ret)
}
/// Accept a pending connection or block until new connection appears
/// Depends on Sock_FD_Flags of the `sock` parameter.
/// Available since Linux 2.0
accept :: proc "contextless" (sock: Fd, addr: ^$T, sockflags: Socket_FD_Flags = {}) -> (Fd, Errno)
where
T == Sock_Addr_In ||
T == Sock_Addr_In6 ||
T == Sock_Addr_Any
{
ret := syscall(SYS_accept4, sock, addr, size_of(T), transmute(int) sockflags)
return errno_unwrap(ret, Fd)
}
// TODO(flysand): Rewrite recvfrom and sendto to use default parameters
recvfrom :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg, addr: ^$T) -> (int, Errno)
where
T == Sock_Addr_In ||
T == Sock_Addr_In6 ||
T == Sock_Addr_Any
{
addr_len: i32 = size_of(T)
ret := syscall(SYS_recvfrom, sock, raw_data(buf), len(buf), transmute(i32) flags, addr, &addr_len)
return errno_unwrap(ret, int)
}
@private
recv_noaddr :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg) -> (int, Errno) {
ret := syscall(SYS_recvfrom, sock, raw_data(buf), len(buf), transmute(i32) flags, cast(rawptr) nil, cast(uintptr) 0)
return errno_unwrap(ret, int)
}
sendto :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg, addr: ^$T) -> (int, Errno)
where
T == Sock_Addr_In ||
T == Sock_Addr_In6 ||
T == Sock_Addr_Any
{
ret := syscall(SYS_sendto, sock, raw_data(buf), len(buf), transmute(i32) flags, addr, size_of(T))
return errno_unwrap(ret, int)
}
@private
send_noaddr :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg) -> (int, Errno) {
ret := syscall(SYS_sendto, sock, raw_data(buf), len(buf), transmute(i32) flags, cast(rawptr) nil, cast(uintptr) 0)
return errno_unwrap(ret, int)
}
/// Receive a message from a socket
/// Available since Linux 2.0
recv :: proc {recvfrom, recv_noaddr}
/// Send a message through a socket
/// Available since Linux 2.0
send :: proc {sendto, send_noaddr}
// TODO(flysand): sendmsg
// TODO(flysand): recvmsg
shutdown :: proc "contextless" (sock: Fd, how: Shutdown_How) -> (Errno) {
ret := syscall(SYS_shutdown, sock, how)
return Errno(-ret)
}
/// Bind a socket to the given local address
/// Available since Linux 2.0
bind :: proc "contextless" (sock: Fd, addr: ^$T) -> (Errno)
where
T == Sock_Addr_In ||
T == Sock_Addr_In6 ||
T == Sock_Addr_Any
{
ret := syscall(SYS_bind, sock, addr, size_of(T))
return Errno(-ret)
}
/// Marks the socket as a socket that listen to connections using accept.2
/// Available since Linux 2.0
listen :: proc "contextless" (sock: Fd, queue_len: i32) -> (Errno) {
ret := syscall(SYS_listen, sock, queue_len)
return Errno(-ret)
}
// TODO(flysand): getsockname
// TODO(flysand): getpeername
// TODO(flysand): socketpair
// TODO(flysand): the parameters are the same, maybe there's a way to make it into a single proc, sacrificing type
// safety slightly
// TODO(flysand): add ability to specify slices
setsockopt_base :: proc "contextless" (sock: Fd, level: int, opt: int, val: $T) -> (Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
val_data := val
val_size := size_of(intrinsics.type_elem_type(T))
ret := syscall(SYS_setsockopt, sock, level, opt, val_data, val_size)
return Errno(-ret)
}
setsockopt_sock :: proc "contextless" (sock: Fd, level: Socket_API_Level_Sock, opt: Socket_Option, val: $T) -> (Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
setsockopt_tcp :: proc "contextless" (sock: Fd, level: Socket_API_Level_TCP, opt: Socket_TCP_Option, val: $T) -> (Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
setsockopt_udp :: proc "contextless" (sock: Fd, level: Socket_API_Level_UDP, opt: Socket_UDP_Option, val: $T) -> (Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
/// Set socket option for a given socket API level
/// Available since Linux 2.0
setsockopt :: proc {
setsockopt_sock,
setsockopt_tcp,
setsockopt_udp,
setsockopt_base,
}
getsockopt_base :: proc "contextless" (sock: Fd, level: int, opt: Socket_Option, val: $T) -> (int, Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
val_data := val
val_size := size_of(T)
ret := syscall(SYS_getsockopt, sock, level, opt, val_data, cast(rawptr) &val_size)
return val_size, Errno(-ret)
}
getsockopt_sock :: proc "contextless" (sock: Fd, level: Socket_API_Level_Sock, opt: Socket_Option, val: ^$T) -> (int, Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
getsockopt_tcp :: proc "contextless" (sock: Fd, level: Socket_API_Level_TCP, opt: Socket_TCP_Option, val: ^$T) -> (int, Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
getsockopt_udp :: proc "contextless" (sock: Fd, level: Socket_API_Level_UDP, opt: Socket_UDP_Option, val: ^$T) -> (int, Errno)
where
intrinsics.type_is_pointer(T) ||
intrinsics.type_is_multi_pointer(T)
{
return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
}
/// Get socket option for a given socket API level
/// Available since Linux 2.0
getsockopt :: proc {
getsockopt_sock,
getsockopt_tcp,
getsockopt_udp,
getsockopt_base,
}
// TODO(flysand): clone (probably not in this PR, maybe not ever)
/// Creates a copy of the running process
/// Available since Linux 1.0
fork :: proc "contextless" () -> (Pid, Errno) {
when ODIN_ARCH == .arm64 {
// Note(flysand): this syscall is not documented, but the bottom 8 bits of flags
// are for exit signal
ret := syscall(SYS_clone, Signal.SIGCHLD)
return errno_unwrap(ret, Pid)
} else {
ret := syscall(SYS_fork)
return errno_unwrap(ret, Pid)
}
}
// TODO(flysand): vfork
// TODO(flysand): execve
/// Exit the thread with a given exit code
/// Available since Linux 1.0
exit :: proc "contextless" (code: i32) -> ! {
syscall(SYS_exit, code)
unreachable()
}
/// Wait for the process to change state
/// Available since Linux 1.0
wait4 :: proc "contextless" (pid: Pid, status: ^u32, options: Wait_Options) -> (Pid, Errno) {
ret := syscall(SYS_wait4, pid, status, transmute(u32) options)
return errno_unwrap(ret, Pid)
}
/// See wait4
waitpid :: wait4
// TODO(flysand): kill
/// Get system information
/// Available since Linux 1.0
uname :: proc "contextless" (uts_name: ^UTS_Name) -> (Errno) {
ret := syscall(SYS_uname, uts_name)
return Errno(-ret)
}
// TODO(flysand): semget
// TODO(flysand): semop
// TODO(flysand): semctl
// TODO(flysand): shmdt
// TODO(flysand): msgget
// TODO(flysand): msgsnd
// TODO(flysand): msgrcv
// TODO(flysand): msgctl
fcntl_dupfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_DUPFD, newfd: Fd) -> (Fd, Errno) {
ret := syscall(SYS_fcntl, fd, cmd, newfd)
return errno_unwrap(ret, Fd)
}
fcntl_dupfd_cloexec :: proc "contextless" (fd: Fd, cmd: FCntl_Command_DUPFD_CLOEXEC, newfd: Fd) -> (Fd, Errno) {
ret := syscall(SYS_fcntl, fd, cmd, newfd)
return errno_unwrap(ret, Fd)
}
fcntl_getfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETFD) -> (Fd, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(ret, Fd)
}
fcntl_setfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETFD, newfd: Fd) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, newfd)
return Errno(-ret)
}
fcntl_getfl :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETFL) -> (Open_Flags, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(u32(ret), Open_Flags, Open_Flags)
}
fcntl_setfl :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETFL, flags: Open_Flags) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, transmute(u32) flags)
return Errno(-ret)
}
fcntl_setlk :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLK, lock: ^FLock) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_fcntl64, fd, cmd, lock)
return Errno(-ret)
} else {
ret := syscall(SYS_fcntl, fd, cmd, lock)
return Errno(-ret)
}
}
fcntl_setlkw :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLKW, lock: ^FLock) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_fcntl64, fd, cmd, lock)
return Errno(-ret)
} else {
ret := syscall(SYS_fcntl, fd, cmd, lock)
return Errno(-ret)
}
}
fcntl_getlk :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETLK, lock: ^FLock) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_fcntl64, fd, cmd, lock)
return Errno(-ret)
} else {
ret := syscall(SYS_fcntl, fd, cmd, lock)
return Errno(-ret)
}
}
fcntl_getown_ex :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETOWN_EX, owner: ^F_Owner) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, owner)
return Errno(-ret)
}
fcntl_setown_ex :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETOWN_EX, owner: ^F_Owner) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, owner)
return Errno(-ret)
}
fcntl_getsig :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETSIG) -> (Signal, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(ret, Signal)
}
fcntl_setsig :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETSIG, sig: Signal) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, sig)
return Errno(-ret)
}
fcntl_setlease :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLEASE, lease: FD_Lease) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, lease)
return Errno(-ret)
}
fcntl_getlease :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETLEASE) -> (FD_Lease, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(ret, FD_Lease)
}
fcntl_notify :: proc "contextless" (fd: Fd, cmd: FCntl_Command_NOTIFY, notifications: FD_Notifications) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return Errno(-ret)
}
fcntl_setpipe_sz :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETPIPE_SZ, sz: i32) -> (i32, Errno) {
ret := syscall(SYS_fcntl, fd, cmd, sz)
return errno_unwrap(ret, i32)
}
fcntl_getpipe_sz :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETPIPE_SZ) -> (i32, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(ret, i32)
}
fcntl_add_seals :: proc "contextless" (fd: Fd, cmd: FCntl_Command_ADD_SEALS, seal: Seal) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, transmute(i32) seal)
return Errno(-ret)
}
fcntl_get_seals :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_SEALS) -> (Seal, Errno) {
ret := syscall(SYS_fcntl, fd, cmd)
return errno_unwrap(i32(ret), Seal, Seal)
}
fcntl_get_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_RW_HINT, hint: ^RW_Hint) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, hint)
return Errno(-ret)
}
fcntl_set_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SET_RW_HINT, hint: ^RW_Hint) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, hint)
return Errno(-ret)
}
fcntl_get_file_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_FILE_RW_HINT, hint: ^RW_Hint) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, hint)
return Errno(-ret)
}
fcntl_set_file_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SET_FILE_RW_HINT, hint: ^RW_Hint) -> (Errno) {
ret := syscall(SYS_fcntl, fd, cmd, hint)
return Errno(-ret)
}
fcntl :: proc {
fcntl_dupfd,
fcntl_dupfd_cloexec,
fcntl_getfd,
fcntl_setfd,
fcntl_getfl,
fcntl_setfl,
fcntl_setlk,
fcntl_setlkw,
fcntl_getlk,
fcntl_getown_ex,
fcntl_setown_ex,
fcntl_getsig,
fcntl_setsig,
fcntl_setlease,
fcntl_getlease,
fcntl_notify,
fcntl_setpipe_sz,
fcntl_getpipe_sz,
fcntl_add_seals,
fcntl_get_seals,
fcntl_get_rw_hint,
fcntl_set_rw_hint,
fcntl_get_file_rw_hint,
fcntl_set_file_rw_hint,
}
// TODO(flysand): flock
/// Sync state of the file with the storage device
fsync :: proc "contextless" (fd: Fd) -> (Errno) {
ret := syscall(SYS_fsync, fd)
return Errno(-ret)
}
// TODO(flysand): fdatasync
/// Truncate a file to specified length
/// On 32-bit architectures available since Linux 2.4
truncate :: proc "contextless" (name: cstring, length: i64) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_truncate64, cast(rawptr) name, compat64_arg_pair(length))
return Errno(-ret)
} else {
ret := syscall(SYS_truncate, cast(rawptr) name, compat64_arg_pair(length))
return Errno(-ret)
}
}
/// Truncate a file specified by file descriptor to specified length
/// On 32-bit architectures available since 2.4
ftruncate :: proc "contextless" (fd: Fd, length: i64) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_ftruncate64, fd, compat64_arg_pair(length))
return Errno(-ret)
} else {
ret := syscall(SYS_truncate, fd, compat64_arg_pair(length))
return Errno(-ret)
}
}
/// Retrieve the contents of the directory specified by dirfd
/// Returns the number of bytes written
/// Available since Linux 2.4
getdents :: proc "contextless" (dirfd: Fd, buf: []u8) -> (int, Errno) {
ret := syscall(SYS_getdents64, dirfd, raw_data(buf), len(buf))
return errno_unwrap(ret, int)
}
/// Get current working directory
/// Available since Linux 1.0
getcwd :: proc "contextless" (buf: []u8) -> (int, Errno) {
ret := syscall(SYS_getcwd, raw_data(buf), len(buf))
return errno_unwrap(ret, int)
}
/// Change working directory to the directory specified by path
/// Available since Linux 1.0
chdir :: proc "contextless" (path: cstring) -> (Errno) {
ret := syscall(SYS_chdir, cast(rawptr) path)
return Errno(-ret)
}
/// Change working directory to the directory specified by dirfd
/// Available since Linux 1.0
fchdir :: proc "contextless" (fd: Fd) -> (Errno) {
ret := syscall(SYS_fchdir, fd)
return Errno(-ret)
}
/// Rename (move) the file
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
rename :: proc "contextless" (old: cstring, new: cstring) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_renameat, AT_FDCWD, cast(rawptr) old, AT_FDCWD, cast(rawptr) new)
return Errno(-ret)
} else {
ret := syscall(SYS_rename, cast(rawptr) old, cast(rawptr) new)
return Errno(-ret)
}
}
/// Creates a directory
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
mkdir :: proc "contextless" (name: cstring, mode: Mode) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_mkdirat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode)
return Errno(-ret)
} else {
ret := syscall(SYS_mkdir, cast(rawptr) name, transmute(u32) mode)
return Errno(-ret)
}
}
/// Remove a directory specified by name
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
rmdir :: proc "contextless" (name: cstring) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_unlinkat, AT_FDCWD, cast(rawptr) name, transmute(i32) FD_Flags{.REMOVEDIR})
return Errno(-ret)
} else {
ret := syscall(SYS_rmdir, cast(rawptr) name)
return Errno(-ret)
}
}
// TODO(flysand): creat
/// Create a hard link on a file
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
link :: proc "contextless" (target: cstring, linkpath: cstring) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_linkat, AT_FDCWD, cast(rawptr) target, AT_FDCWD, cast(rawptr) linkpath)
return Errno(-ret)
} else {
ret := syscall(SYS_link, cast(rawptr) target, cast(rawptr) linkpath)
return Errno(-ret)
}
}
/// Delete a name, and possible a file it refers to
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
unlink :: proc "contextless" (name: cstring) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_unlinkat, AT_FDCWD, cast(rawptr) name, 0)
return Errno(-ret)
} else {
ret := syscall(SYS_unlink, cast(rawptr) name)
return Errno(-ret)
}
}
/// Create a symbolic link
/// Available since Linux 1.0
/// On arm64 available since Linux 2.6.16
symlink :: proc "contextless" (target: cstring, linkpath: cstring) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_symlinkat, AT_FDCWD, cast(rawptr) target, cast(rawptr) linkpath)
return Errno(-ret)
} else {
ret := syscall(SYS_symlink, cast(rawptr) target, cast(rawptr) linkpath)
return Errno(-ret)
}
}
/// Read the value of a symbolic link
/// Available since Linux 1.0
/// On arm64 available since Linux 2.6.16
readlink :: proc "contextless" (name: cstring, buf: []u8) -> (int, Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_readlinkat, AT_FDCWD, cast(rawptr) name, raw_data(buf), len(buf))
return errno_unwrap(ret, int)
} else {
ret := syscall(SYS_readlink, cast(rawptr) name, raw_data(buf), len(buf))
return errno_unwrap(ret, int)
}
}
/// Change file permissions
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
chmod :: proc "contextless" (name: cstring, mode: Mode) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_fchmodat, cast(rawptr) name, transmute(u32) mode, 0)
return Errno(-ret)
} else {
ret := syscall(SYS_chmod, cast(rawptr) name, transmute(u32) mode)
return Errno(-ret)
}
}
/// Change file permissions through a file descriptor
/// Available since Linux 1.0
fchmod :: proc "contextless" (fd: Fd, mode: Mode) -> (Errno) {
ret := syscall(SYS_fchmod, fd, transmute(u32) mode)
return Errno(-ret)
}
/// Change ownership of a file
/// Available since Linux 2.2
/// On 32-bit architectures available since Linux 2.4
/// On ARM64 available since Linux 2.6.16
chown :: proc "contextless" (name: cstring, uid: Uid, gid: Gid) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_chown32, cast(rawptr) name, uid, gid)
return Errno(-ret)
} else when ODIN_ARCH == .arm64 {
ret := syscall(SYS_fchownat, AT_FDCWD, cast(rawptr) name, uid, gid, 0)
return Errno(-ret)
} else {
ret := syscall(SYS_chown, cast(rawptr) name, uid, gid)
return Errno(-ret)
}
}
/// Change ownership of a file by file descriptor
/// Available since Linux 1.0
/// On 32-bit architecvtures available since Linux 2.4
fchown :: proc "contextless" (fd: Fd, uid: Uid, gid: Gid) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_fchown32, fd, uid, gid)
return Errno(-ret)
} else {
ret := syscall(SYS_fchown, fd, uid, gid)
return Errno(-ret)
}
}
/// Change ownership of a file. Unlike chown, if a file is a symlink dooesn't dereference it
/// Available since Linux 1.0
/// On 32-bit architectures available since Linux 2.4
/// On ARM64 available since Linux 2.6.16
lchown :: proc "contextless" (name: cstring, uid: Uid, gid: Gid) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_lchown32, cast(rawptr) name, uid, gid)
return Errno(-ret)
} else when ODIN_ARCH == .arm64 {
ret := syscall(SYS_fchownat, AT_FDCWD, cast(rawptr) name, uid, gid, transmute(i32) FD_Flags{.SYMLINK_NOFOLLOW})
return Errno(-ret)
} else {
ret := syscall(SYS_lchown, cast(rawptr) name, uid, gid)
return Errno(-ret)
}
}
// TODO(flysand): umask
// TODO(flysand): gettimeofday
/// Get limits on resources
/// Available since Linux 1.0
getrlimit :: proc "contextless" (kind: RLimit_Kind, resource: ^RLimit) -> (Errno) {
ret := syscall(SYS_getrlimit, kind, resource)
return Errno(-ret)
}
/// Get resource usage
/// Available since Linux 1.0
getrusage :: proc "contextless" (who: RUsage_Who, rusage: ^RUsage) -> (Errno) {
ret := syscall(SYS_getrusage, who, rusage)
return Errno(-ret)
}
/// Get information about the system
sysinfo :: proc "contextless" (sysinfo: ^Sys_Info) -> (Errno) {
ret := syscall(SYS_sysinfo, sysinfo)
return Errno(-ret)
}
/// Get current process times
/// Available since Linux 1.0
times :: proc "contextless" (tms: ^Tms) -> (Errno) {
ret := syscall(SYS_times, cast(rawptr) tms)
return Errno(-ret)
}
// TODO(flysand): ptrace
/// Get real user ID
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
getuid :: proc "contextless" () -> Uid {
when size_of(int) == 8 {
return cast(Uid) syscall(SYS_getuid)
} else {
return cast(Uid) syscall(SYS_getuid32)
}
}
// TODO(flysand): syslog
/// Get real group ID
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
getgid :: proc "contextless" () -> Gid {
when size_of(int) == 8 {
return cast(Gid) syscall(SYS_getgid)
} else {
return cast(Gid) syscall(SYS_getgid32)
}
}
/// Set effective user id
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setuid :: proc "contextless" (uid: Uid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setuid, uid)
return Errno(-ret)
} else {
ret := syscall(SYS_setuid32, uid)
return Errno(-ret)
}
}
/// Set effective group id
/// If the process is privileged also sets real group id
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setgid :: proc "contextless" (gid: Gid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setgid, gid)
return Errno(-ret)
} else {
ret := syscall(SYS_setgid32, gid)
return Errno(-ret)
}
}
/// Get effective user ID
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
geteuid :: proc "contextless" () -> Uid {
when size_of(int) == 8 {
return cast(Uid) syscall(SYS_geteuid)
} else {
return cast(Uid) syscall(SYS_geteuid32)
}
}
/// Get effective group ID
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
getegid :: proc "contextless" () -> Gid {
when size_of(int) == 8 {
return cast(Gid) syscall(SYS_getegid)
} else {
return cast(Gid) syscall(SYS_getegid32)
}
}
/// Set process group
/// Available since Linux 1.0
setpgid :: proc "contextless" (pid: Pid, pgid: Pid) -> (Errno) {
ret := syscall(SYS_setpgid, pid, pgid)
return Errno(-ret)
}
/// Get the parent process ID
/// Available since Linux 1.0
getppid :: proc "contextless" () -> Pid {
return cast(Pid) syscall(SYS_getppid)
}
/// Get process group
/// Available since Linux 1.0
getpgrp :: proc "contextless" () -> (Pid, Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_getpgid, 0)
return errno_unwrap(ret, Pid)
} else {
ret := syscall(SYS_getpgrp)
return errno_unwrap(ret, Pid)
}
}
/// Create a session and set the process group ID
/// Available since Linux 2.0
setsid :: proc "contextless" () -> (Errno) {
ret := syscall(SYS_setsid)
return Errno(-ret)
}
/// Set real and/or effective user id
/// If any of the arguments is -1, the corresponding id is not changed
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setreuid :: proc "contextless" (real: Uid, effective: Uid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setreuid, real, effective)
return Errno(-ret)
} else {
ret := syscall(SYS_setreuid32, real, effective)
return Errno(-ret)
}
}
/// Set real and/or effective group id
/// If any of the arguments is -1, the corresponding id is not changed
/// Available since Linux 1.0
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setregid :: proc "contextless" (real: Gid, effective: Gid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setregid, real, effective)
return Errno(-ret)
} else {
ret := syscall(SYS_setregid32, real, effective)
return Errno(-ret)
}
}
// TODO(flysand): getgroups
// TODO(flysand): setgroups
/// Set real, effective and/or saved user id
/// If any of the arguments is -1, the corresponding id is not changed
/// Available since Linux 2.2
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setresuid :: proc "contextless" (real: Uid, effective: Uid, saved: Uid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setresuid, real, effective, saved)
return Errno(-ret)
} else {
ret := syscall(SYS_setresuid32, real, effective, saved)
return Errno(-ret)
}
}
/// Get real, effective and saved user id
/// Available since Linux 2.2
/// On 32-bit platforms available since Linux 2.4
getresuid :: proc "contextless" (real: ^Uid, effective: ^Uid, saved: ^Uid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_getresuid, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
return Errno(-ret)
} else {
ret := syscall(SYS_getresuid32, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
return Errno(-ret)
}
}
/// Set real, effective and/or saved group id
/// If any of the arguments is -1, the corresponding id is not changed
/// Available since Linux 2.2
/// On 32-bit platforms available since Linux 2.4
@(require_results)
setresgid :: proc "contextless" (real: Gid, effective: Gid, saved: Uid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_setresgid, real, effective, saved)
return Errno(-ret)
} else {
ret := syscall(SYS_setresgid32, real, effective, saved)
return Errno(-ret)
}
}
/// Get real, effective and saved group id
/// Available since Linux 2.2
/// On 32-bit platforms available since Linux 2.4
getresgid :: proc "contextless" (real: ^Gid, effective: ^Gid, saved: ^Gid) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_getresgid, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
return Errno(-ret)
} else {
ret := syscall(SYS_getresgid32, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
return Errno(-ret)
}
}
/// Get process group
/// Available since Linux 1.0
getpgid :: proc "contextless" (pid: Pid) -> (Pid, Errno) {
ret := syscall(SYS_getpgid, pid)
return errno_unwrap(ret, Pid)
}
// NOTE(flysand): setfsuid and setfsgid are deprecated
/// Get session ID of the calling process
/// Available since Linux 2.0
getsid :: proc "contextless" (pid: Pid) -> (Pid, Errno) {
ret := syscall(SYS_getsid, pid)
return errno_unwrap(ret, Pid)
}
// TODO(flysand): capget
// TODO(flysand): capset
/// Examine pending signals
/// Available since Linux 2.2
rt_sigpending :: proc "contextless" (sigs: ^Sig_Set) -> Errno {
ret := syscall(SYS_rt_sigpending, sigs, size_of(Sig_Set))
return Errno(-ret)
}
/// Synchronously wait for queued signals
/// Available since Linux 2.2
rt_sigtimedwait :: proc "contextless" (sigs: ^Sig_Set, info: ^Sig_Info, time_sus: ^Time_Spec) -> (Signal, Errno) {
ret := syscall(SYS_rt_sigtimedwait, sigs, info, time_sus, size_of(Sig_Set))
return errno_unwrap(ret, Signal)
}
/// Send signal information to a process
/// Available since Linux 2.2
rt_sigqueueinfo :: proc "contextless" (pid: Pid, sig: Signal, si: ^Sig_Info) -> (Errno) {
ret := syscall(SYS_rt_sigqueueinfo, pid, sig, si)
return Errno(-ret)
}
/// Replace the signal mask for a value with the new mask until a signal is received
/// Available since Linux 2.2
rt_sigsuspend :: proc "contextless" (sigset: ^Sig_Set) -> Errno {
ret := syscall(SYS_rt_sigsuspend, sigset, size_of(Sig_Set))
return Errno(-ret)
}
/// Set or get signal stack context
/// Available since Linux 2.2
sigaltstack :: proc "contextless" (stack: ^Sig_Stack, old_stack: ^Sig_Stack) -> (Errno) {
ret := syscall(SYS_sigaltstack, stack, old_stack)
return Errno(-ret)
}
// TODO(flysand): utime
/// Create a special or ordinary file
/// `mode` parameter contains both the the file mode and the type of the node to create
/// -> Add one of S_IFSOCK, S_IFBLK, S_IFFIFO, S_IFCHR to mode
/// Available since Linux 1.0
/// On ARM64 available since Linux 2.6.16
mknod :: proc "contextless" (name: cstring, mode: Mode, dev: Dev) -> (Errno) {
when ODIN_ARCH == .arm64 {
ret := syscall(SYS_mknodat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode, dev)
return Errno(-ret)
} else {
ret := syscall(SYS_mknod, cast(rawptr) name, transmute(u32) mode, dev)
return Errno(-ret)
}
}
// TODO(flysand): uselib
/// Set the process execution domain
/// Available since Linux 1.2
personality :: proc "contextless" (personality: uint) -> (uint, Errno) {
ret := syscall(SYS_personality, personality)
return errno_unwrap(ret, uint)
}
// TODO(flysand): ustat
/// Query information about filesystem
///
/// Available since Linux 1.0
/// For 32-bit systems a different syscall is used that became available since 2.6
statfs :: proc "contextless" (path: cstring, statfs: ^Stat_FS) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_statfs, transmute(uintptr) path, statfs)
return Errno(-ret)
} else {
ret := syscall(SYS_statfs64, cast(rawptr) path, size_of(Stat_FS), statfs)
return Errno(-ret)
}
}
/// Query information about filesystem by file descriptor
///
/// Available since Linux 1.0
/// For 32-bit systems a different syscall is used that became available since 2.6
fstatfs :: proc "contextless" (fd: Fd, statfs: ^Stat_FS) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_statfs, fd, statfs)
return Errno(-ret)
} else {
ret := syscall(SYS_statfs64, fd, size_of(Stat_FS), statfs)
return Errno(-ret)
}
}
// TODO(flysand): sysfs
/// Get priority on user, process group or process
/// Available since Linux 1.0
getpriority :: proc "contextless" (which: Priority_Which, who: i32) -> (i32, Errno) {
ret := syscall(SYS_getpriority, which, who)
prio, err := errno_unwrap(ret, i32)
// NOTE(flysand): getpriority will return `20 - priority` to avoid returning
// negative priorities as errors
prio = 20 - prio
return prio, err
}
/// Set priority on user, process group or process
/// Available since Linux 1.0
setpriority :: proc "contextless" (which: Priority_Which, who: i32, prio: i32) -> (Errno) {
ret := syscall(SYS_setpriority, which, who, prio)
return Errno(-ret)
}
// TODO(flysand): sched_setparam
// TODO(flysand): sched_getparam
// TODO(flysand): sched_setscheduler
// TODO(flysand): sched_getscheduler
// TODO(flysand): sched_get_priority_max
// TODO(flysand): sched_get_priority_min
// TODO(flysand): sched_rr_get_interval
/// Lock and memory
/// Available since Linux 2.0
/// If flags specified, available since Linux 4.4
mlock :: proc "contextless" (addr: rawptr, size: uint, flags: MLock_Flags = {}) -> (Errno) {
// Pretty darn recent syscall, better call simpler version if we can
if flags > {} {
ret := syscall(SYS_mlock2, addr, size, transmute(i32) flags)
return Errno(-ret)
} else {
ret := syscall(SYS_mlock, addr, size)
return Errno(-ret)
}
}
/// Unlock memory
/// Available since Linux 2.0
munlock :: proc "contextless" (addr: rawptr, size: uint) -> (Errno) {
ret := syscall(SYS_munlock, addr, size)
return Errno(-ret)
}
/// Lock all memory
mlockall :: proc "contextless" (flags: MLock_Flags = {}) -> (Errno) {
ret := syscall(SYS_mlockall, transmute(i32) flags)
return Errno(-ret)
}
/// Unlock all memory
munlockall :: proc "contextless" () -> (Errno) {
ret := syscall(SYS_munlockall)
return Errno(-ret)
}
// TODO(flysand): vhangup
// TODO(flysand): modify_ldt
// TODO(flysand): pivot_root
// TODO(flysand): _sysctl
// TODO(flysand): prctl
// TODO(flysand): arch_prctl
// TODO(flysand): adj_timex
/// Set limits on resources
/// Available since Linux 1.0
setrlimit :: proc "contextless" (kind: RLimit_Kind, resource: ^RLimit) -> (Errno) {
ret := syscall(SYS_setrlimit, kind, resource)
return Errno(-ret)
}
// TODO(flysand): sync
// TODO(flysand): acct
// TODO(flysand): settimeofday
// TODO(flysand): mount
// TODO(flysand): umount2
// TODO(flysand): swapon
// TODO(flysand): swapoff
// TODO(flysand): reboot
/// Set hostname
/// Note: to get the host name, use `uname` syscall
/// Available since Linux 1.0
sethostname :: proc "contextless" (hostname: string) -> (Errno) {
ret := syscall(SYS_sethostname, raw_data(hostname), len(hostname))
return Errno(-ret)
}
/// Set domain name
/// Note: to get the domain name, use `uname` syscall
/// Available since Linux 2.2
setdomainname :: proc "contextless" (name: string) -> (Errno) {
ret := syscall(SYS_setdomainname, raw_data(name), len(name))
return Errno(-ret)
}
// TODO(flysand): iopl
// TODO(flysand): ioperm
// TODO(flysand): create_module
// TODO(flysand): init_module
// TODO(flysand): delete_module
// TODO(flysand): get_kernel_syms
// TODO(flysand): query_module
// TODO(flysand): quotactl
// TODO(flysand): nfsservctl
// TODO(flysand): getpmsg
// TODO(flysand): putpmsg
// TODO(flysand): afs_syscall
// TODO(flysand): tuxcall
// TODO(flysand): security
/// Returns the thread ID of the current process
/// This is what the kernel calls "pid"
/// Let me insert a tiny rant here, this terminology is confusing:
/// sometimes pid refers to a thread, and other times it refers
/// to a thread group (process group?)
/// Anyway, this syscall is available since Linux 1.0
gettid :: proc "contextless" () -> Pid {
return cast(Pid) syscall(SYS_gettid)
}
// TODO(flysand): readahead
// TODO(flysand): setxattr
// TODO(flysand): lsetxattr
// TODO(flysand): fsetxattr
// TODO(flysand): getxattr
// TODO(flysand): lgetxattr
// TODO(flysand): fgetxattr
// TODO(flysand): listxattr
// TODO(flysand): llistxattr
// TODO(flysand): flistxattr
// TODO(flysand): removexattr
// TODO(flysand): lremovexattr
// TODO(flysand): fremovexattr
// TODO(flysand): tkill
// TODO(flysand): time
/// Wait on a futex until it's signaled
futex_wait :: proc "contextless" (futex: ^Futex, op: Futex_Wait_Type, flags: Futex_Flags, val: u32, timeout: ^Time_Spec = nil) -> (Errno) {
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, val, timeout)
return Errno(-ret)
}
/// Wake up other threads on a futex
/// n_wakeup specifies the number of processes to wakeup. Specify max(i32) to wake up all processes waiting
futex_wake :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Type, flags: Futex_Flags, n_wakeup: i32) -> (int, Errno) {
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, n_wakeup)
return errno_unwrap(ret, int)
}
// NOTE(flysand): futex_fd is racy, so not implemented
/// Requeues processes waiting on futex `futex` to wait on futex `requeue_futex`
/// `requeue_threshold` specifies the maximum amount of waiters to wake up, the rest of the waiters will be requeued
/// `requeue_max` specifies the maximum amount of waiters that are required at `requeue_futex`
/// The operation blocks until the `requeue_max` requirement is satisfied
/// If the value of the mutex is not equal to `val`, fails with EAGAIN before any further checks
/// Returns the total number of waiters that have been woken up plus the number of waiters requeued
futex_cmp_requeue :: proc "contextless" (futex: ^Futex, op: Futex_Cmp_Requeue_Type, flags: Futex_Flags, requeue_threshold: u32,
requeue_max: i32, requeue_futex: ^Futex, val: i32) -> (int, Errno)
{
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, requeue_threshold, requeue_max, requeue_futex, val)
return errno_unwrap(ret, int)
}
/// See `futex_cmp_requeue`, this function does the same thing but doesn't check the value of the futex
/// Returns the total number of waiters that have been woken up
futex_requeue :: proc "contextless" (futex: ^Futex, op: Futex_Requeue_Type, flags: Futex_Flags, requeue_threshold: u32,
requeue_max: i32, requeue_futex: ^Futex) -> (int, Errno)
{
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, requeue_threshold, requeue_max, requeue_futex)
return errno_unwrap(ret, int)
}
/// Okay, for this one, see the man pages, the description for it is pretty long and very specific. It's sole
/// purpose is to allow implementing conditional values sync primitive, it seems like
futex_wake_op :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Op_Type, flags: Futex_Flags, wakeup: i32,
dst_wakeup, dst: ^Futex, futex_op: u32) -> (int, Errno)
{
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, wakeup, dst_wakeup, dst, futex_op)
return errno_unwrap(ret, int)
}
/// Same as wait, but mask specifies bits that must be equal for the mutex to wake up
futex_wait_bitset :: proc "contextless" (futex: ^Futex, op: Futex_Wait_Bitset_Type, flags: Futex_Flags, val: u32,
timeout: ^Time_Spec, mask: u32) -> (int, Errno)
{
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, val, timeout, 0, mask)
return errno_unwrap(ret, int)
}
/// Wake up on bitset
futex_wake_bitset :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Bitset_Type, flags: Futex_Flags, n_wakeup: u32, mask: u32) -> (int, Errno)
{
futex_flags := cast(u32) op + transmute(u32) flags
ret := syscall(SYS_futex, futex, futex_flags, n_wakeup, 0, 0, mask)
return errno_unwrap(ret, int)
}
// TODO(flysand): Priority inheritance (PI) futicees
futex :: proc {
futex_wait,
futex_wake,
futex_cmp_requeue,
futex_requeue,
futex_wake_op,
futex_wait_bitset,
futex_wake_bitset,
}
// TODO(flysand): sched_setaffinity
// TODO(flysand): sched_getaffinity
// TODO(flysand): set_thread_area
// TODO(flysand): io_setup
// TODO(flysand): io_destroy
// TODO(flysand): io_getevents
// TODO(flysand): io_submit
// TODO(flysand): io_cancel
// TODO(flysand): get_thread_area
// TODO(flysand): lookup_dcookie
// TODO(flysand): epoll_create
// TODO(flysand): epoll_ctl_old
// TODO(flysand): epoll_wait_old
// TODO(flysand): remap_file_pages
/// Set the address of the futex that's gonna be waken when
/// current thread terminates
/// Available since Linux 2.6
set_tid_address :: proc "contextless" (tidptr: ^u32) {
syscall(SYS_set_tid_address, tidptr)
}
// TODO(flysand): restart_syscall
// TODO(flysand): semtimedop
// TODO(flysand): fadvise64
// TODO(flysand): timer_create
// TODO(flysand): timer_settime
// TODO(flysand): timer_gettime
// TODO(flysand): timer_getoverrun
// TODO(flysand): timer_delete
// TODO(flysand): clock_settime
// TODO(flysand): clock_gettime
// TODO(flysand): clock_getres
// TODO(flysand): clock_nanosleep
/// Exit the thread group
/// Available since Linux 2.6
exit_group :: proc "contextless" (code: i32) -> ! {
syscall(SYS_exit_group, code)
unreachable()
}
// TODO(flysand): epoll_wait
// TODO(flysand): epoll_ctl
// TODO(flysand): tgkill
// TODO(flysand): utimes
// TODO(flysand): vserver
// TODO(flysand): mbind
// TODO(flysand): set_mempolicy
// TODO(flysand): get_mempolicy
// TODO(flysand): mq_open
// TODO(flysand): mq_unlink
// TODO(flysand): mq_timedsend
// TODO(flysand): mq_timedreceive
// TODO(flysand): mq_notify
// TODO(flysand): mq_getsetattr
// TODO(flysand): kexec_load
/// Wait on process, process group or pid file descriptor
/// Available since Linux 2.6.10
waitid :: proc "contextless" (id_type: Id_Type, id: Id, sig_info: ^Sig_Info, options: Wait_Options) -> (Errno) {
ret := syscall(SYS_waitid, id_type, id, sig_info, transmute(i32) options)
return Errno(-ret)
}
// TODO(flysand): add_key
// TODO(flysand): request_key
// TODO(flysand): keyctl
// TODO(flysand): ioprio_set
// TODO(flysand): ioprio_get
// TODO(flysand): inotify_init
// TODO(flysand): inotify_add_watch
// TODO(flysand): inotify_rm_watch
// TODO(flysand): migrate_pages
/// Open file at the specified file descriptor
/// Available since Linux 2.6.16
openat :: proc "contextless" (fd: Fd, name: cstring, flags: Open_Flags, mode: Mode = {}) -> (Fd, Errno) {
ret := syscall(SYS_openat, fd, AT_FDCWD, transmute(uintptr) name, transmute(u32) mode)
return errno_unwrap(ret, Fd)
}
/// Create a directory relative to specified dirfd
/// Available since Linux 2.6.16
mkdirat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode) -> (Errno) {
ret := syscall(SYS_mkdirat, dirfd, cast(rawptr) name, transmute(u32) mode)
return Errno(-ret)
}
/// Create a special or ordinary file wrt given directory specified by dirfd
/// Available since Linux 2.6.16
mknodat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode, dev: Dev) -> (Errno) {
ret := syscall(SYS_mknodat, dirfd, cast(rawptr) name, transmute(u32) mode, dev)
return Errno(-ret)
}
/// Change the ownership of the file specified relative to directory
/// Available since Linux 2.6.16
fchownat :: proc "contextless" (dirfd: Fd, name: cstring, uid: Uid, gid: Gid) -> (Errno) {
ret := syscall(SYS_fchownat, dirfd, cast(rawptr) name, uid, gid)
return Errno(-ret)
}
// TODO(flysand): futimesat
/// Get information about a file at a specific directory
/// Available since Linux 2.6.16
fstatat :: proc "contextless" (dirfd: Fd, name: cstring, stat: ^Stat, flags: FD_Flags) -> (Errno) {
when size_of(int) == 4 {
ret := syscall(SYS_fstatat64, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
return Errno(-ret)
} else when ODIN_ARCH == .amd64 {
ret := syscall(SYS_newfstatat, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
return Errno(-ret)
} else {
ret := syscall(SYS_fstatat, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
return Errno(-ret)
}
}
/// Remove a directory entry relative to a directory file descriptor
/// Available since Linux 2.6.16
unlinkat :: proc "contextless" (dirfd: Fd, name: cstring, flags: FD_Flags) -> (Errno) {
ret := syscall(SYS_unlinkat, dirfd, cast(rawptr) name, transmute(i32) flags)
return Errno(-ret)
}
/// Rename the file with names relative to the specified dirfd's
/// Available since Linux 2.6.16
renameat :: proc "contextless" (oldfd: Fd, old: cstring, newfd: Fd, new: cstring) -> (Errno) {
ret := syscall(SYS_renameat, oldfd, cast(rawptr) old, newfd, cast(rawptr) new)
return Errno(-ret)
}
/// Creates a hard link on a file relative to specified dirfd
/// Available since Linux 2.6.16
linkat :: proc "contextless" (target_dirfd: Fd, oldpath: cstring, link_dirfd: Fd, link: cstring, flags: FD_Flags) -> (Errno) {
ret := syscall(SYS_linkat, target_dirfd, cast(rawptr) oldpath, link_dirfd, cast(rawptr) link, transmute(i32) flags)
return Errno(-ret)
}
/// Create a symbolic link at specified dirfd
/// Available since Linux 2.6.16
symlinkat :: proc "contextless" (dirfd: Fd, target: cstring, linkpath: cstring) -> (Errno) {
ret := syscall(SYS_symlinkat, dirfd, cast(rawptr) target, cast(rawptr) linkpath)
return Errno(-ret)
}
/// Read the value of a symbolic link at given dirfd
/// Available since Linux 2.6.16
readlinkat :: proc "contextless" (dirfd: Fd, name: cstring, buf: []u8) -> (int, Errno) {
ret := syscall(SYS_readlinkat, dirfd, cast(rawptr) name, raw_data(buf), len(buf))
return errno_unwrap(ret, int)
}
/// Change the file mode at a specified file descriptor
/// Available since Linux 2.6.16
fchmodat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode, flags: FD_Flags) -> (Errno) {
ret := syscall(SYS_fchmodat, cast(rawptr) name, transmute(u32) mode, transmute(i32) flags)
return Errno(-ret)
}
/// Checks the user permissions for a file at specified dirfd
/// Available since Linux 2.6.16
faccessat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode = F_OK) -> (bool, Errno) {
ret := syscall(SYS_faccessat, dirfd, cast(rawptr) name, transmute(u32) mode)
return errno_unwrap(ret, bool)
}
// TODO(flysand): pselect6
/// Wait for events on a file descriptor
/// Available since Linux 2.6.16
ppoll :: proc "contextless" (fds: []Poll_Fd, timeout: ^Time_Spec, sigmask: ^Sig_Set) -> (Errno) {
when size_of(int) == 8 {
ret := syscall(SYS_ppoll, raw_data(fds), len(fds), timeout, sigmask, size_of(Sig_Set))
return Errno(-ret)
} else {
ret := syscall(SYS_ppoll_time64, raw_data(fds), len(fds), timeout, sigmask, size_of(Sig_Set))
return Errno(-ret)
}
}
// TODO(flysand): unshare
// TODO(flysand): set_robust_list
// TODO(flysand): get_robust_list
// TODO(flysand): splice
// TODO(flysand): tee
// TODO(flysand): sync_file_range
// TODO(flysand): vmsplice
// TODO(flysand): move_pages
/// Change file timestamps with nanosecond precision
/// Available since Linux 2.6.22
utimensat :: proc "contextless" (dirfd: Fd, name: cstring, timespec: ^Time_Spec, flags: FD_Flags) -> (Errno) {
ret := syscall(SYS_utimensat, dirfd, cast(rawptr) name, timespec, transmute(i32) flags)
return Errno(-ret)
}
// TODO(flysand): epoll_pwait
// TODO(flysand): signalfd
// TODO(flysand): timerfd_create
// TODO(flysand): eventfd
// TODO(flysand): fallocate
// TODO(flysand): timerfd_settime
// TODO(flysand): timerfd_gettime
// TODO(flysand): accept4
// TODO(flysand): signalfd4
// TODO(flysand): eventfd2
// TODO(flysand): epoll_create1
/// Adjust an existing file descriptor to point to the same file as `old`
/// In addition to dup2 allows to pass O_CLOEXEC flag
/// Available since Linux 2.6.27
dup3 :: proc "contextless" (old: Fd, new: Fd, flags: Open_Flags) -> (Fd, Errno) {
ret := syscall(SYS_dup3, old, new, transmute(i32) flags)
return errno_unwrap(ret, Fd)
}
// TODO(flysand): inotify_init1
// TODO(flysand): preadv
// TODO(flysand): pwritev
/// Send signal information to a thread
/// Available since Linux 2.2
rt_tgsigqueueinfo :: proc "contextless" (tgid: Pid, pid: Pid, sig: Signal, si: ^Sig_Info) -> (Errno) {
ret := syscall(SYS_rt_tgsigqueueinfo, tgid, pid, sig, si)
return Errno(-ret)
}
/// Set up performance monitoring
/// Available since Linux 2.6.31
perf_event_open :: proc "contextless" (attr: ^Perf_Event_Attr, pid: Pid, cpu: int, group_fd: Fd, flags: Perf_Flags = {}) -> (Fd, Errno) {
ret := syscall(SYS_perf_event_open, attr, pid, cpu, group_fd, transmute(uint) flags)
return errno_unwrap(ret, Fd)
}
// TODO(flysand): recvmmsg
// TODO(flysand): fanotify_init
// TODO(flysand): fanotify_mark
// TODO(flysand): prlimit64
// TODO(flysand): name_to_handle_at
// TODO(flysand): open_by_handle_at
// TODO(flysand): clock_adjtime
// TODO(flysand): syncfs
// TODO(flysand): sendmmsg
// TODO(flysand): setns
// TODO(flysand): getcpu
// TODO(flysand): process_vm_readv
// TODO(flysand): process_vm_writev
// TODO(flysand): kcmp
// TODO(flysand): finit_module
// TODO(flysand): sched_setattr
// TODO(flysand): sched_getattr
/// Rename the file with names relative to the specified dirfd's with other options
/// Available since Linux 3.15
renameat2 :: proc "contextless" (oldfd: Fd, old: cstring, newfd: Fd, new: cstring, flags: Rename_Flags) -> (Errno) {
ret := syscall(SYS_renameat2, oldfd, cast(rawptr) old, newfd, cast(rawptr) new, transmute(u32) flags)
return Errno(-ret)
}
// TODO(flysand): seccomp
getrandom :: proc "contextless" (buf: []u8, flags: Get_Random_Flags) -> (int, Errno) {
ret := syscall(SYS_getrandom, raw_data(buf), len(buf), transmute(i32) flags)
return errno_unwrap(ret, int)
}
// TODO(flysand): memfd_create
// TODO(flysand): kexec_file_load
// TODO(flysand): bpf
// TODO(flysand): execveat
// TODO(flysand): userfaultfd
// TODO(flysand): membarrier
// TODO(flysand): mlock2
// TODO(flysand): copy_file_range
// TODO(flysand): preadv2
// TODO(flysand): pwritev2
// TODO(flysand): pkey_mprotect
// TODO(flysand): pkey_alloc
// TODO(flysand): pkey_free
/// Query extended information about the file
///
/// The file can be specified as:
/// absolute pathname: `dir` parameter is ignored
/// relatvie pathname: `dir` parameter specifies the base directory's fd
/// file descriptor: `AT_EMPTY_PATH` is passed in flags, pathname is empty, `dir` specifies the file descriptor
///
/// Available since Linux 4.11
statx :: proc "contextless" (dir: Fd, pathname: cstring, flags: FD_Flags, mask: Statx_Mask, statx: ^Statx) -> (Errno) {
ret := syscall(SYS_statx, dir, transmute(uintptr) pathname, transmute(i32) flags, transmute(u32) mask, statx)
return Errno(-ret)
}
// TODO(flysand): io_pgetevents
// TODO(flysand): rseq
// TODO(flysand): pidfd_send_signal
// TODO(flysand): io_uring_setup
// TODO(flysand): io_uring_enter
// TODO(flysand): io_uring_register
// TODO(flysand): open_tree
// TODO(flysand): move_mount
// TODO(flysand): fsopen
// TODO(flysand): fsconfig
// TODO(flysand): fsmount
// TODO(flysand): fspick
/// Creates a new PID file descriptor
/// The process identified by `pid` must be a pid group leader
/// The returned `pidfd` has `CLOEXEC` semantics
/// Available since Linux 5.3
pidfd_open :: proc "contextless" (pid: Pid, flags: Pid_FD_Flags) -> (Pid_FD, Errno) {
ret := syscall(SYS_pidfd_open, pid, transmute(i32) flags)
return errno_unwrap(ret, Pid_FD)
}
// TODO(flysand): clone3 (probably not this PR)
/// Close the range of files as an atomic operation
/// The range of file descriptors is inclusive, and may contain invalid file descriptors
/// Available since Linux 5.9
close_range :: proc "contextless" (lo: Fd, hi: Fd, flags: Close_Range_Flags) -> (Errno) {
ret := syscall(SYS_close_range, lo, hi, transmute(u32) flags)
return Errno(-ret)
}
// TODO(flysand): openat2
/// Get a file descriptor from another process
/// `fd` refers to a file descriptor number to get
/// `flags` must be zero
/// Available since Linux 5.3
pidfd_getfd :: proc "contextless" (pidfd: Pid_FD, fd: Fd, flags: i32 = 0) -> (Fd, Errno) {
ret := syscall(SYS_pidfd_getfd, pidfd, fd, flags)
return errno_unwrap(ret, Fd)
}
/// Checks the user permissions for a file at specified dirfd (with flags)
/// Available since Linux 5.8
faccessat2 :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode = F_OK, flags: FD_Flags = FD_Flags{}) -> (bool, Errno) {
ret := syscall(SYS_faccessat2, dirfd, cast(rawptr) name, transmute(u32) mode, transmute(i32) flags)
return errno_unwrap(ret, bool)
}
// TODO(flysand): process_madvise
// TODO(flysand): epoll_pwait2
// TODO(flysand): mount_setattr
// TODO(flysand): quotactl_fd
// TODO(flysand): landlock_create_ruleset
// TODO(flysand): landlock_add_rule
// TODO(flysand): landlock_restrict_self
// TODO(flysand): memfd_secret
// TODO(flysand): process_mrelease
// TODO(flysand): futex_waitv
// TODO(flysand): set_mempolicy_home_node
// TODO(flysand): cachestat
// TODO(flysand): fchmodat2
// TODO(flysand): map_shadow_stack