sys.odin 81 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995
  1. //+no-instrumentation
  2. package linux
  3. import "base:intrinsics"
  4. /*
  5. Read data from file into the buffer
  6. Returns the number of bytes successfully read, which may be less than the size
  7. of the buffer even if the termination is successfull.
  8. Available since Linux 1.0.
  9. Before Linux 3.14, this operation is not atomic (i.e. not thread safe).
  10. */
  11. read :: proc "contextless" (fd: Fd, buf: []u8) -> (int, Errno) {
  12. ret := syscall(SYS_read, fd, raw_data(buf), len(buf))
  13. return errno_unwrap(ret, int)
  14. }
  15. /*
  16. Write the data from a buffer into the file
  17. Returns the number of bytes successfully written, which may be less than the size
  18. of the buffer, even if the termination is successfull
  19. When using direct I/O, error doesn't mean the write has failed. Partial data may
  20. have been written.
  21. If .Eintr is returned, the write operation has failed due to interrupt. You'll probably
  22. need to restart this syscall
  23. Available since Linux 1.0
  24. Before Linux 3.14 this operation is not atomic (i.e. not thread safe)
  25. */
  26. write :: proc "contextless" (fd: Fd, buf: []u8) -> (int, Errno) {
  27. ret := syscall(SYS_write, fd, raw_data(buf), len(buf))
  28. return errno_unwrap(ret, int)
  29. }
  30. /*
  31. Open file, get the file descriptor
  32. Available since Linux 1.0.
  33. On ARM64 available since Linux 2.6.16.
  34. */
  35. open :: proc "contextless" (name: cstring, flags: Open_Flags, mode: Mode = {}) -> (Fd, Errno) {
  36. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  37. ret := syscall(SYS_openat, AT_FDCWD, transmute(uintptr) name, transmute(u32) flags, transmute(u32) mode)
  38. return errno_unwrap(ret, Fd)
  39. } else {
  40. ret := syscall(SYS_open, transmute(uintptr) name, transmute(u32) flags, transmute(u32) mode)
  41. return errno_unwrap(ret, Fd)
  42. }
  43. }
  44. /*
  45. Close the file.
  46. Available since Linux 1.0.
  47. */
  48. close :: proc "contextless" (fd: Fd) -> (Errno) {
  49. ret := syscall(SYS_close, fd)
  50. return Errno(-ret)
  51. }
  52. /*
  53. Get file status.
  54. Returns information about the file in struct pointed to by `stat` parameter.
  55. Available since Linux 1.0
  56. For 32-bit systems a different syscall is used that became available since 2.4.
  57. Not available on ARM64.
  58. */
  59. stat :: proc "contextless" (filename: cstring, stat: ^Stat) -> (Errno) {
  60. when size_of(int) == 8 {
  61. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  62. ret := syscall(SYS_fstatat, AT_FDCWD, cast(rawptr) filename, stat, 0)
  63. return Errno(-ret)
  64. } else {
  65. ret := syscall(SYS_stat, cast(rawptr) filename, stat)
  66. return Errno(-ret)
  67. }
  68. } else {
  69. ret := syscall(SYS_stat64, cast(rawptr) filename, stat)
  70. return Errno(-ret)
  71. }
  72. }
  73. /*
  74. Get file status from file descriptor.
  75. Returns information about the file in struct pointed to by `stat` parameter.
  76. Available since Linux 1.0.
  77. For 32-bit systems a different syscall is used that became available since 2.4.
  78. */
  79. fstat :: proc "contextless" (fd: Fd, stat: ^Stat) -> (Errno) {
  80. when size_of(int) == 8 {
  81. ret := syscall(SYS_fstat, cast(i32) fd, stat)
  82. return Errno(-ret)
  83. } else {
  84. ret := syscall(SYS_fstat64, cast(i32) fd, stat)
  85. return Errno(-ret)
  86. }
  87. }
  88. /*
  89. Get information about the file that's potentially a symbolic link
  90. The information is returned in a struct pointed to by `stat` parameter.
  91. The difference with stat, fstat is that if the file is a symbolic link,
  92. stat and fstat will dereference the link. lstat doesn't dereference symlinks.
  93. Available since Linux 1.0.
  94. For 32-bit systems a different syscall is used that became available since 2.4.
  95. Not available on arm64.
  96. */
  97. lstat :: proc "contextless" (filename: cstring, stat: ^Stat) -> (Errno) {
  98. when size_of(int) == 8 {
  99. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  100. return fstatat(AT_FDCWD, filename, stat, {.SYMLINK_NOFOLLOW})
  101. } else {
  102. ret := syscall(SYS_lstat, cast(rawptr) filename, stat)
  103. return Errno(-ret)
  104. }
  105. } else {
  106. ret := syscall(SYS_lstat64, cast(rawptr) filename, stat)
  107. return Errno(-ret)
  108. }
  109. }
  110. /*
  111. Wait on event on a file descriptor.
  112. Available since Linux 2.2.
  113. */
  114. poll :: proc "contextless" (fds: []Poll_Fd, timeout: i32) -> (i32, Errno) {
  115. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  116. seconds := cast(uint) timeout / 1000
  117. nanoseconds := cast(uint) (timeout % 1000) * 1_000_000
  118. timeout_spec := Time_Spec{seconds, nanoseconds}
  119. ret := syscall(SYS_ppoll, raw_data(fds), len(fds), &timeout_spec, 0, 0)
  120. return errno_unwrap(ret, i32)
  121. } else {
  122. ret := syscall(SYS_poll, raw_data(fds), len(fds), timeout)
  123. return errno_unwrap(ret, i32)
  124. }
  125. }
  126. /*
  127. Seek the file stream to specified offset.
  128. Available since Linux 1.0.
  129. On 32-bit platforms available since Linux 1.2.
  130. */
  131. lseek :: proc "contextless" (fd: Fd, off: i64, whence: Seek_Whence) -> (i64, Errno) {
  132. when size_of(int) == 8 {
  133. ret := syscall(SYS_lseek, fd, off, whence)
  134. return errno_unwrap(ret, i64)
  135. } else {
  136. result: i64 = ---
  137. ret := syscall(SYS__llseek, fd, compat64_arg_pair(off), &result, whence)
  138. return result, Errno(-ret)
  139. }
  140. }
  141. /*
  142. Map files into memory.
  143. Available since Linux 1.0.
  144. On 32-bit platforms since Linux 1.0.
  145. */
  146. mmap :: proc "contextless" (addr: uintptr, size: uint, prot: Mem_Protection, flags: Map_Flags, fd: Fd = Fd(-1), offset: i64 = 0) -> (rawptr, Errno) {
  147. when size_of(int) == 8 {
  148. ret := syscall(SYS_mmap, addr, size, transmute(i32) prot, transmute(i32) flags, fd, offset)
  149. return errno_unwrap(ret, rawptr, uintptr)
  150. } else {
  151. ret := syscall(SYS_mmap2, addr, size, transmute(i32) prot, transmute(i32) flags, fd, cast(uintptr)(offset/4096))
  152. return errno_unwrap(ret, rawptr, uintptr)
  153. }
  154. }
  155. /*
  156. Protect memory region.
  157. Available since Linux 1.0.
  158. */
  159. mprotect :: proc "contextless" (addr: rawptr, size: uint, prot: Mem_Protection) -> (Errno) {
  160. ret := syscall(SYS_mprotect, addr, size, transmute(i32) prot)
  161. return Errno(-ret)
  162. }
  163. /*
  164. Unmap memory.
  165. Available since Linux 1.0.
  166. */
  167. munmap :: proc "contextless" (addr: rawptr, size: uint) -> (Errno) {
  168. ret := syscall(SYS_munmap, addr, size)
  169. return Errno(-ret)
  170. }
  171. /*
  172. Extend the data segment size until the address `addr`. Note: you may be
  173. familiar with sbrk(), which is not actually a syscall, so is not
  174. implemented here.
  175. Available since Linux 1.0.
  176. */
  177. brk :: proc "contextless" (addr: uintptr) -> (Errno) {
  178. ret := syscall(SYS_brk, addr)
  179. return Errno(-ret)
  180. }
  181. /*
  182. Returns from signal handlers on some archs.
  183. */
  184. rt_sigreturn :: proc "c" () -> ! {
  185. intrinsics.syscall(uintptr(SYS_rt_sigreturn))
  186. unreachable()
  187. }
  188. /*
  189. Alter an action taken by a process.
  190. */
  191. rt_sigaction :: proc "contextless" (sig: Signal, sigaction: ^Sig_Action($T), old_sigaction: ^Sig_Action) -> Errno {
  192. // NOTE(jason): It appears that the restorer is required for i386 and amd64
  193. when ODIN_ARCH == .i386 || ODIN_ARCH == .amd64 {
  194. sigaction.flags += {.RESTORER}
  195. }
  196. if sigaction != nil && sigaction.restorer == nil && .RESTORER in sigaction.flags {
  197. sigaction.restorer = rt_sigreturn
  198. }
  199. ret := syscall(SYS_rt_sigaction, sig, sigaction, old_sigaction, size_of(Sig_Set))
  200. return Errno(-ret)
  201. }
  202. /*
  203. Examime and alter blocked signals.
  204. Available since Linux 2.2.
  205. */
  206. rt_sigprocmask :: proc "contextless" (mask_kind: Sig_Mask_Kind, new_set: ^Sig_Set, old_set: ^Sig_Set) -> Errno {
  207. ret := syscall(SYS_rt_sigprocmask, mask_kind, new_set, old_set, size_of(Sig_Set))
  208. return Errno(-ret)
  209. }
  210. /*
  211. Control devices. The ioctl syscall is a bit special because
  212. its argument is usually a pointer to some driver-specific structure.
  213. The request value is device-specific. Consult your LibC implementation's
  214. ioctls.h file to learn more. The returned value of ioctl *may* be an error
  215. code value instead of a memory address depending on the request type.
  216. Available since Linux 1.0.
  217. */
  218. ioctl :: proc "contextless" (fd: Fd, request: u32, arg: uintptr) -> (uintptr) {
  219. ret := syscall(SYS_ioctl, fd, request, arg)
  220. return uintptr(ret)
  221. }
  222. /*
  223. Read the file at a specified offset.
  224. Note, it is not an error to return less bytes than requested.
  225. Available since Linux 2.2.
  226. */
  227. pread :: proc "contextless" (fd: Fd, buf: []u8, offset: i64) -> (int, Errno) {
  228. ret := syscall(SYS_pread64, fd, raw_data(buf), len(buf), compat64_arg_pair(offset))
  229. return errno_unwrap(ret, int)
  230. }
  231. /*
  232. Read the file at a specified offset.
  233. Note, it is not an error to return less bytes than requested.
  234. Available since Linux 2.2.
  235. */
  236. pwrite :: proc "contextless" (fd: Fd, buf: []u8, offset: i64) -> (int, Errno) {
  237. ret := syscall(SYS_pwrite64, fd, raw_data(buf), len(buf), compat64_arg_pair(offset))
  238. return errno_unwrap(ret, int)
  239. }
  240. /*
  241. Read the data from file into multiple buffers.
  242. Available since Linux 2.0.
  243. */
  244. readv :: proc "contextless" (fd: Fd, iov: []IO_Vec) -> (int, Errno) {
  245. ret := syscall(SYS_readv, fd, raw_data(iov), len(iov))
  246. return errno_unwrap(ret, int)
  247. }
  248. /*
  249. Write the data from multiple buffers into a file.
  250. Available since Linux 2.0.
  251. */
  252. writev :: proc "contextless" (fd: Fd, iov: []IO_Vec) -> (int, Errno) {
  253. ret := syscall(SYS_writev, fd, raw_data(iov), len(iov))
  254. return errno_unwrap(ret, int)
  255. }
  256. /*
  257. Check user permissions for a file.
  258. If Mode is F_OK, checks whether the file exists.
  259. Similarly, X_OK, W_OK, R_OK check if the file is executable, writeable, readable respectively.
  260. Available since Linux 1.0.
  261. For ARM64 available since Linux 2.6.16.
  262. */
  263. access :: proc "contextless" (name: cstring, mode: Mode = F_OK) -> (Errno) {
  264. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  265. ret := syscall(SYS_faccessat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode)
  266. return Errno(-ret)
  267. } else {
  268. ret := syscall(SYS_access, cast(rawptr) name, transmute(u32) mode)
  269. return Errno(-ret)
  270. }
  271. }
  272. /*
  273. Create a pipe
  274. Available since Linux 2.6.27
  275. */
  276. pipe2 :: proc "contextless" (pipes: ^[2]Fd, flags: Open_Flags) -> (Errno) {
  277. ret := syscall(SYS_pipe2, pipes, transmute(u32) flags)
  278. return Errno(-ret)
  279. }
  280. /*
  281. Yield the processor.
  282. Available since Linux 2.0.
  283. */
  284. sched_yield :: proc "contextless" () {
  285. syscall(SYS_sched_yield)
  286. }
  287. /*
  288. Remap a virtual memory address.
  289. Available since Linux 2.0.
  290. */
  291. mremap :: proc "contextless" (old_addr: rawptr, old_size: uint, new_size: uint, flags: MRemap_Flags, new_addr: uintptr = 0) -> (rawptr, Errno) {
  292. if .FIXED in flags {
  293. ret := syscall(SYS_mremap, old_addr, old_size, new_size, transmute(i32) flags, new_addr)
  294. return errno_unwrap(ret, rawptr, rawptr)
  295. } else {
  296. ret := syscall(SYS_mremap, old_addr, old_size, new_size, transmute(i32) flags)
  297. return errno_unwrap(ret, rawptr, rawptr)
  298. }
  299. }
  300. /*
  301. Sync file with memory map.
  302. Available since Linux 2.0.
  303. */
  304. msync :: proc "contextless" (addr: rawptr, size: uint, flags: MSync_Flags) -> (Errno) {
  305. ret := syscall(SYS_msync, addr, size, transmute(i32) flags)
  306. return Errno(-ret)
  307. }
  308. /*
  309. Determine if pages are resident in memory.
  310. Available since Linux 2.4.
  311. */
  312. mincore :: proc "contextless" (addr: rawptr, size: uint, vec: []b8) -> (Errno) {
  313. ret := syscall(SYS_mincore, addr, size, raw_data(vec))
  314. return Errno(-ret)
  315. }
  316. /*
  317. Give advice about use of memory.
  318. Available since Linux 2.4.
  319. */
  320. madvise :: proc "contextless" (addr: rawptr, size: uint, advice: MAdvice) -> (Errno) {
  321. ret := syscall(SYS_madvise, addr, size, advice)
  322. return Errno(-ret)
  323. }
  324. /*
  325. Allocate a SystemV shared memory segment.
  326. Available since Linux 2.0.
  327. */
  328. shmget :: proc "contextless" (key: Key, size: uint, flags: IPC_Flags) -> (Key, Errno) {
  329. ret := syscall(SYS_shmget, key, size, transmute(i16) flags)
  330. return errno_unwrap(ret, Key)
  331. }
  332. /*
  333. SystemV shared memory segment operations.
  334. Available since Linux 2.0.
  335. */
  336. shmat :: proc "contextless" (key: Key, addr: rawptr, flags: IPC_Flags) -> (rawptr, Errno) {
  337. ret := syscall(SYS_shmat, key, addr, transmute(i16) flags)
  338. return errno_unwrap(ret, rawptr, uintptr)
  339. }
  340. shmctl_ds :: proc "contextless" (key: Key, cmd: IPC_Cmd, buf: ^Shmid_DS) -> (Errno) {
  341. ret := syscall(SYS_shmctl, key, cmd, buf)
  342. return Errno(-ret)
  343. }
  344. shmctl_info :: proc "contextless" (key: Key, cmd: IPC_Cmd, buf: ^Shm_Info) -> (int, Errno) {
  345. ret := syscall(SYS_shmctl, key, cmd, buf)
  346. return errno_unwrap(ret, int)
  347. }
  348. /*
  349. SystemV shared memory control.
  350. Available since Linux 2.0.
  351. */
  352. shmctl :: proc {shmctl_ds, shmctl_info}
  353. /*
  354. Allocate a new file descriptor that refers to the same file as the one provided.
  355. Available since Linux 1.0.
  356. */
  357. dup :: proc "contextless" (fd: Fd) -> (Fd, Errno) {
  358. ret := syscall(SYS_dup, fd)
  359. return errno_unwrap(ret, Fd)
  360. }
  361. /*
  362. Adjust an existing file descriptor to point to the same file as `old`.
  363. Available since Linux 1.0.
  364. On ARM64 available since Linux 2.6.27.
  365. */
  366. dup2 :: proc "contextless" (old: Fd, new: Fd) -> (Fd, Errno) {
  367. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  368. ret := syscall(SYS_dup3, old, new, 0)
  369. return errno_unwrap(ret, Fd)
  370. } else {
  371. ret := syscall(SYS_dup2, old, new)
  372. return errno_unwrap(ret, Fd)
  373. }
  374. }
  375. /*
  376. Wait until the next signal is delivered.
  377. Available since Linux 1.0.
  378. On ARM64 available since Linux 2.6.16.
  379. */
  380. pause :: proc "contextless" () {
  381. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  382. syscall(SYS_ppoll, 0, 0, 0, 0)
  383. } else {
  384. syscall(SYS_pause)
  385. }
  386. }
  387. /*
  388. High-resolution sleep.
  389. Available since Linux 2.0.
  390. */
  391. nanosleep :: proc "contextless" (req: ^Time_Spec, rem: ^Time_Spec) -> (Errno) {
  392. ret := syscall(SYS_nanosleep, req, rem)
  393. return Errno(-ret)
  394. }
  395. /*
  396. Get the value of an internal timer.
  397. Available since Linux 1.0.
  398. */
  399. getitimer :: proc "contextless" (which: ITimer_Which, cur: ^ITimer_Val) -> (Errno) {
  400. ret := syscall(SYS_getitimer, cur)
  401. return Errno(-ret)
  402. }
  403. /*
  404. Set an alarm clock for delivery of a signal.
  405. Available since Linux 1.0.
  406. */
  407. alarm :: proc "contextless" (seconds: u32) -> u32 {
  408. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  409. new := ITimer_Val { value = { seconds = cast(int) seconds } }
  410. old := ITimer_Val {}
  411. syscall(SYS_setitimer, ITimer_Which.REAL, &new, &old)
  412. return u32(old.value.seconds) + u32(new.value.microseconds)
  413. } else {
  414. return cast(u32) syscall(SYS_alarm, seconds)
  415. }
  416. }
  417. /*
  418. Set the value of an internal timer.
  419. Available since Linux 1.0.
  420. */
  421. setitimer :: proc "contextless" (which: ITimer_Which, new: ^ITimer_Val, old: ^ITimer_Val) -> (Errno) {
  422. ret := syscall(SYS_getitimer, new, old)
  423. return Errno(-ret)
  424. }
  425. /*
  426. Returns the thread group ID of the current process.
  427. Note that it doesn't return the pid, despite it's name.
  428. Available since Linux 1.0.
  429. */
  430. getpid :: proc "contextless" () -> Pid {
  431. return cast(Pid) syscall(SYS_getpid)
  432. }
  433. /*
  434. Transfer the data between file descriptors.
  435. Available since Linux 2.2.
  436. On 32-bit platforms available since Linux 2.6.
  437. */
  438. sendfile :: proc "contextless" (out_fd: Fd, in_fd: Fd, offset: ^i64, count: uint) -> (int, Errno) {
  439. when size_of(int) == 8 {
  440. ret := syscall(SYS_sendfile, out_fd, in_fd, offset, count)
  441. return errno_unwrap(ret, int)
  442. } else {
  443. ret := syscall(SYS_sendfile64, out_fd, in_fd, offset, count)
  444. return errno_unwrap(ret, int)
  445. }
  446. }
  447. /*
  448. Create a socket file descriptor.
  449. Available since Linux 2.0.
  450. */
  451. socket :: proc "contextless" (domain: Address_Family, socktype: Socket_Type, sockflags: Socket_FD_Flags, protocol: Protocol) -> (Fd, Errno) {
  452. sock_type_flags: int = cast(int) socktype | transmute(int) sockflags
  453. ret := syscall(SYS_socket, domain, sock_type_flags, protocol)
  454. return errno_unwrap(ret, Fd)
  455. }
  456. /*
  457. Connect the socket to the address.
  458. Available since Linux 2.0.
  459. */
  460. connect :: proc "contextless" (sock: Fd, addr: ^$T) -> (Errno)
  461. where
  462. T == Sock_Addr_In ||
  463. T == Sock_Addr_In6 ||
  464. T == Sock_Addr_Un ||
  465. T == Sock_Addr_Any
  466. {
  467. ret := syscall(SYS_connect, sock, addr, size_of(T))
  468. return Errno(-ret)
  469. }
  470. /*
  471. Accept a pending connection or block until new connection appears.
  472. Depends on Sock_FD_Flags of the `sock` parameter.
  473. Available since Linux 2.0.
  474. */
  475. accept :: proc "contextless" (sock: Fd, addr: ^$T, sockflags: Socket_FD_Flags = {}) -> (Fd, Errno)
  476. where
  477. T == Sock_Addr_In ||
  478. T == Sock_Addr_In6 ||
  479. T == Sock_Addr_Un ||
  480. T == Sock_Addr_Any
  481. {
  482. addr_len: i32 = size_of(T)
  483. ret := syscall(SYS_accept4, sock, addr, &addr_len, transmute(int) sockflags)
  484. return errno_unwrap(ret, Fd)
  485. }
  486. // TODO(flysand): Rewrite recvfrom and sendto to use default parameters
  487. recvfrom :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg, addr: ^$T) -> (int, Errno)
  488. where
  489. T == Sock_Addr_In ||
  490. T == Sock_Addr_In6 ||
  491. T == Sock_Addr_Un ||
  492. T == Sock_Addr_Any
  493. {
  494. addr_len: i32 = size_of(T)
  495. ret := syscall(SYS_recvfrom, sock, raw_data(buf), len(buf), transmute(i32) flags, addr, &addr_len)
  496. return errno_unwrap(ret, int)
  497. }
  498. @private
  499. recv_noaddr :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg) -> (int, Errno) {
  500. ret := syscall(SYS_recvfrom, sock, raw_data(buf), len(buf), transmute(i32) flags, cast(rawptr) nil, cast(uintptr) 0)
  501. return errno_unwrap(ret, int)
  502. }
  503. sendto :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg, addr: ^$T) -> (int, Errno)
  504. where
  505. T == Sock_Addr_In ||
  506. T == Sock_Addr_In6 ||
  507. T == Sock_Addr_Un ||
  508. T == Sock_Addr_Any
  509. {
  510. ret := syscall(SYS_sendto, sock, raw_data(buf), len(buf), transmute(i32) flags, addr, size_of(T))
  511. return errno_unwrap(ret, int)
  512. }
  513. @private
  514. send_noaddr :: proc "contextless" (sock: Fd, buf: []u8, flags: Socket_Msg) -> (int, Errno) {
  515. ret := syscall(SYS_sendto, sock, raw_data(buf), len(buf), transmute(i32) flags, cast(rawptr) nil, cast(uintptr) 0)
  516. return errno_unwrap(ret, int)
  517. }
  518. /*
  519. Receive a message from a socket.
  520. Available since Linux 2.0.
  521. */
  522. recv :: proc {recvfrom, recv_noaddr}
  523. /*
  524. Send a message through a socket.
  525. Available since Linux 2.0.
  526. */
  527. send :: proc {sendto, send_noaddr}
  528. /*
  529. Send a message on a socket.
  530. Available since Linux 2.0.
  531. */
  532. sendmsg :: proc "contextless" (sock: Fd, msghdr: ^Msg_Hdr, flags: Socket_Msg) -> (int, Errno) {
  533. ret := syscall(SYS_sendmsg, sock, msghdr, transmute(i32) flags)
  534. return errno_unwrap(ret, int)
  535. }
  536. /*
  537. Receive a message on a socket.
  538. Available since Linux 2.0.
  539. */
  540. recvmsg :: proc "contextless" (sock: Fd, msghdr: ^Msg_Hdr, flags: Socket_Msg) -> (int, Errno) {
  541. ret := syscall(SYS_recvmsg, sock, msghdr, transmute(i32) flags)
  542. return errno_unwrap(ret, int)
  543. }
  544. /*
  545. Shutdown a socket.
  546. Available since Linux 2.0.
  547. */
  548. shutdown :: proc "contextless" (sock: Fd, how: Shutdown_How) -> (Errno) {
  549. ret := syscall(SYS_shutdown, sock, how)
  550. return Errno(-ret)
  551. }
  552. /*
  553. Bind a socket to the given local address.
  554. Available since Linux 2.0.
  555. */
  556. bind :: proc "contextless" (sock: Fd, addr: ^$T) -> (Errno)
  557. where
  558. T == Sock_Addr_In ||
  559. T == Sock_Addr_In6 ||
  560. T == Sock_Addr_Un ||
  561. T == Sock_Addr_Any
  562. {
  563. ret := syscall(SYS_bind, sock, addr, size_of(T))
  564. return Errno(-ret)
  565. }
  566. /*
  567. Marks the socket as a socket that listen to connections using accept(2).
  568. Available since Linux 2.0.
  569. */
  570. listen :: proc "contextless" (sock: Fd, queue_len: i32) -> (Errno) {
  571. ret := syscall(SYS_listen, sock, queue_len)
  572. return Errno(-ret)
  573. }
  574. /*
  575. Get socket name (aka it's bound address).
  576. Available since Linux 2.0.
  577. */
  578. getsockname :: proc "contextless" (sock: Fd, addr: ^Sock_Addr_Any) -> (Errno) {
  579. addr_len := size_of(Sock_Addr_Any)
  580. ret := syscall(SYS_getsockname, sock, addr, &addr_len)
  581. return Errno(-ret)
  582. }
  583. /*
  584. Get the name of the connected peer socket.
  585. Available since Linux 2.0.
  586. */
  587. getpeername :: proc "contextless" (sock: Fd, addr: ^Sock_Addr_Any) -> (Errno) {
  588. addr_len := size_of(Sock_Addr_Any)
  589. ret := syscall(SYS_getpeername, sock, addr, &addr_len)
  590. return Errno(-ret)
  591. }
  592. /*
  593. Create a pair of connected sockets.
  594. Available since Linux 2.0.
  595. */
  596. socketpair :: proc "contextless" (domain: Protocol_Family, type: Socket_Type, proto: Protocol, pair: ^[2]Fd) -> (Errno) {
  597. ret := syscall(SYS_socketpair, domain, type, proto, pair)
  598. return Errno(-ret)
  599. }
  600. // TODO(flysand): the parameters are the same, maybe there's a way to make it into a single proc, sacrificing type
  601. // safety slightly
  602. // TODO(flysand): add ability to specify slices
  603. setsockopt_base :: proc "contextless" (sock: Fd, level: int, opt: int, val: $T) -> (Errno)
  604. where
  605. intrinsics.type_is_pointer(T) ||
  606. intrinsics.type_is_multi_pointer(T)
  607. {
  608. val_data := val
  609. val_size := size_of(intrinsics.type_elem_type(T))
  610. ret := syscall(SYS_setsockopt, sock, level, opt, val_data, val_size)
  611. return Errno(-ret)
  612. }
  613. setsockopt_sock :: proc "contextless" (sock: Fd, level: Socket_API_Level_Sock, opt: Socket_Option, val: $T) -> (Errno)
  614. where
  615. intrinsics.type_is_pointer(T) ||
  616. intrinsics.type_is_multi_pointer(T)
  617. {
  618. return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
  619. }
  620. setsockopt_tcp :: proc "contextless" (sock: Fd, level: Socket_API_Level_TCP, opt: Socket_TCP_Option, val: $T) -> (Errno)
  621. where
  622. intrinsics.type_is_pointer(T) ||
  623. intrinsics.type_is_multi_pointer(T)
  624. {
  625. return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
  626. }
  627. setsockopt_udp :: proc "contextless" (sock: Fd, level: Socket_API_Level_UDP, opt: Socket_UDP_Option, val: $T) -> (Errno)
  628. where
  629. intrinsics.type_is_pointer(T) ||
  630. intrinsics.type_is_multi_pointer(T)
  631. {
  632. return setsockopt_base(sock, cast(int) level, cast(int) opt, val)
  633. }
  634. /*
  635. Set socket option for a given socket API level.
  636. Available since Linux 2.0.
  637. */
  638. setsockopt :: proc {
  639. setsockopt_sock,
  640. setsockopt_tcp,
  641. setsockopt_udp,
  642. setsockopt_base,
  643. }
  644. getsockopt_base :: proc "contextless" (sock: Fd, level: int, opt: Socket_Option, val: $T) -> (int, Errno)
  645. where
  646. intrinsics.type_is_pointer(T) ||
  647. intrinsics.type_is_multi_pointer(T)
  648. {
  649. val_data := val
  650. val_size := size_of(T)
  651. ret := syscall(SYS_getsockopt, sock, level, opt, val_data, cast(rawptr) &val_size)
  652. return val_size, Errno(-ret)
  653. }
  654. getsockopt_sock :: proc "contextless" (sock: Fd, level: Socket_API_Level_Sock, opt: Socket_Option, val: ^$T) -> (int, Errno)
  655. where
  656. intrinsics.type_is_pointer(T) ||
  657. intrinsics.type_is_multi_pointer(T)
  658. {
  659. return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
  660. }
  661. getsockopt_tcp :: proc "contextless" (sock: Fd, level: Socket_API_Level_TCP, opt: Socket_TCP_Option, val: ^$T) -> (int, Errno)
  662. where
  663. intrinsics.type_is_pointer(T) ||
  664. intrinsics.type_is_multi_pointer(T)
  665. {
  666. return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
  667. }
  668. getsockopt_udp :: proc "contextless" (sock: Fd, level: Socket_API_Level_UDP, opt: Socket_UDP_Option, val: ^$T) -> (int, Errno)
  669. where
  670. intrinsics.type_is_pointer(T) ||
  671. intrinsics.type_is_multi_pointer(T)
  672. {
  673. return getsockopt_base(sock, cast(int) level, cast(int) opt, val)
  674. }
  675. /*
  676. Get socket option for a given socket API level.
  677. Available since Linux 2.0.
  678. */
  679. getsockopt :: proc {
  680. getsockopt_sock,
  681. getsockopt_tcp,
  682. getsockopt_udp,
  683. getsockopt_base,
  684. }
  685. /*
  686. Creates a copy of the running process.
  687. Available since Linux 1.0.
  688. */
  689. fork :: proc "contextless" () -> (Pid, Errno) {
  690. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  691. ret := syscall(SYS_clone, u64(Signal.SIGCHLD), cast(rawptr) nil, cast(rawptr) nil, cast(rawptr) nil, u64(0))
  692. return errno_unwrap(ret, Pid)
  693. } else {
  694. ret := syscall(SYS_fork)
  695. return errno_unwrap(ret, Pid)
  696. }
  697. }
  698. /*
  699. Create a child process and block parent.
  700. Available since Linux 2.2.
  701. */
  702. vfork :: proc "contextless" () -> Pid {
  703. when ODIN_ARCH != .arm64 && ODIN_ARCH != .riscv64 {
  704. return Pid(syscall(SYS_vfork))
  705. } else {
  706. return Pid(syscall(SYS_clone, Signal.SIGCHLD))
  707. }
  708. }
  709. /*
  710. Replace the current process with another program.
  711. Available since Linux 1.0.
  712. On ARM64 available since Linux 3.19.
  713. */
  714. execve :: proc "contextless" (name: cstring, argv: [^]cstring, envp: [^]cstring) -> (Errno) {
  715. when ODIN_ARCH != .arm64 && ODIN_ARCH != .riscv64 {
  716. ret := syscall(SYS_execve, cast(rawptr) name, cast(rawptr) argv, cast(rawptr) envp)
  717. return Errno(-ret)
  718. } else {
  719. ret := syscall(SYS_execveat, AT_FDCWD, cast(rawptr) name, cast(rawptr) argv, cast(rawptr) envp, i32(0))
  720. return Errno(-ret)
  721. }
  722. }
  723. /*
  724. Exit the thread with a given exit code.
  725. Available since Linux 1.0.
  726. */
  727. exit :: proc "contextless" (code: i32) -> ! {
  728. syscall(SYS_exit, code)
  729. unreachable()
  730. }
  731. /*
  732. Wait for the process to change state.
  733. Available since Linux 1.0.
  734. */
  735. wait4 :: proc "contextless" (pid: Pid, status: ^u32, options: Wait_Options, rusage: ^RUsage) -> (Pid, Errno) {
  736. ret := syscall(SYS_wait4, pid, status, transmute(u32) options, rusage)
  737. return errno_unwrap(ret, Pid)
  738. }
  739. /*
  740. See `wait4` for documentation.
  741. */
  742. waitpid :: wait4
  743. /*
  744. Send signal to a process.
  745. Available since Linux 1.0.
  746. */
  747. kill :: proc "contextless" (pid: Pid, signal: Signal) -> (Errno) {
  748. ret := syscall(SYS_kill, pid, signal)
  749. return Errno(-ret)
  750. }
  751. /*
  752. Get system information.
  753. Available since Linux 1.0.
  754. */
  755. uname :: proc "contextless" (uts_name: ^UTS_Name) -> (Errno) {
  756. ret := syscall(SYS_uname, uts_name)
  757. return Errno(-ret)
  758. }
  759. /*
  760. Get a SystemV semaphore set identifier.
  761. Available since Linux 2.0.
  762. */
  763. semget :: proc "contextless" (key: Key, n: i32, flags: IPC_Flags) -> (Key, Errno) {
  764. ret := syscall(SYS_semget, key, n, transmute(i16) flags)
  765. return errno_unwrap(ret, Key)
  766. }
  767. /*
  768. SystemV semaphore operations.
  769. Available since Linux 2.0.
  770. */
  771. semop :: proc "contextless" (key: Key, ops: []Sem_Buf) -> (Errno) {
  772. when ODIN_ARCH != .i386 {
  773. ret := syscall(SYS_semop, key, raw_data(ops), len(ops))
  774. return Errno(-ret)
  775. } else {
  776. // Note(flysand): Max time limit, let's not worry about nanoseconds...
  777. max_timespec := Time_Spec {
  778. time_sec = max(uint),
  779. time_nsec = 0,
  780. }
  781. ret := syscall(SYS_semtimedop_time64, key, raw_data(ops), len(ops), &max_timespec)
  782. return Errno(-ret)
  783. }
  784. }
  785. semctl3 :: proc "contextless" (key: Key, semnum: i32, cmd: IPC_Cmd) -> (int, Errno) {
  786. ret := syscall(SYS_semctl, key, semnum, cmd)
  787. return errno_unwrap(ret, int)
  788. }
  789. semctl4 :: proc "contextless" (key: Key, semnum: i32, cmd: IPC_Cmd, semun: ^Sem_Un) -> (int, Errno) {
  790. ret := syscall(SYS_semctl, key, semnum, cmd, semun)
  791. return errno_unwrap(ret, int)
  792. }
  793. /*
  794. SystemV semaphore control operations.
  795. Available since Linux 2.0.
  796. */
  797. semctl :: proc {semctl3, semctl4}
  798. /*
  799. SystemV shared memory operations.
  800. Available since Linux 2.0.
  801. */
  802. shmdt :: proc "contextless" (shmaddr: rawptr) -> (Errno) {
  803. ret := syscall(SYS_shmdt, shmaddr)
  804. return Errno(-ret)
  805. }
  806. /*
  807. Get SystemV message queue identifier.
  808. Available since Linux 2.0.
  809. */
  810. msgget :: proc "contextless" (key: Key, flags: IPC_Flags) -> (Key, Errno) {
  811. ret := syscall(SYS_msgget, key, transmute(i16) flags)
  812. return errno_unwrap(ret, Key)
  813. }
  814. /*
  815. Send message to a SystemV message queue.
  816. Available since Linux 2.0.
  817. */
  818. msgsnd :: proc "contextless" (key: Key, buf: rawptr, size: int, flags: IPC_Flags) -> (Errno) {
  819. ret := syscall(SYS_msgsnd, key, buf, size, transmute(i16) flags)
  820. return Errno(-ret)
  821. }
  822. /*
  823. Receive a message from a SystemV message queue.
  824. Available since Linux 2.0.
  825. */
  826. msgrcv :: proc "contextless" (key: Key, buf: rawptr, size: int, type: uint, flags: IPC_Flags) -> (int, Errno) {
  827. ret := syscall(SYS_msgrcv, key, buf, size, type, transmute(i16) flags)
  828. return errno_unwrap(ret, int)
  829. }
  830. /*
  831. SystemV message control operations.
  832. Available since Linux 2.0.
  833. */
  834. msgctl :: proc "contextless" (key: Key, cmd: IPC_Cmd, buf: ^Msqid_DS) -> (int, Errno) {
  835. ret := syscall(SYS_msgctl, key, cmd, buf)
  836. return errno_unwrap(ret, int)
  837. }
  838. fcntl_dupfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_DUPFD, newfd: Fd) -> (Fd, Errno) {
  839. ret := syscall(SYS_fcntl, fd, cmd, newfd)
  840. return errno_unwrap(ret, Fd)
  841. }
  842. fcntl_dupfd_cloexec :: proc "contextless" (fd: Fd, cmd: FCntl_Command_DUPFD_CLOEXEC, newfd: Fd) -> (Fd, Errno) {
  843. ret := syscall(SYS_fcntl, fd, cmd, newfd)
  844. return errno_unwrap(ret, Fd)
  845. }
  846. fcntl_getfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETFD) -> (Fd, Errno) {
  847. ret := syscall(SYS_fcntl, fd, cmd)
  848. return errno_unwrap(ret, Fd)
  849. }
  850. fcntl_setfd :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETFD, newfd: Fd) -> (Errno) {
  851. ret := syscall(SYS_fcntl, fd, cmd, newfd)
  852. return Errno(-ret)
  853. }
  854. fcntl_getfl :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETFL) -> (Open_Flags, Errno) {
  855. ret := syscall(SYS_fcntl, fd, cmd)
  856. return errno_unwrap(u32(ret), Open_Flags, Open_Flags)
  857. }
  858. fcntl_setfl :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETFL, flags: Open_Flags) -> (Errno) {
  859. ret := syscall(SYS_fcntl, fd, cmd, transmute(u32) flags)
  860. return Errno(-ret)
  861. }
  862. fcntl_setlk :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLK, lock: ^FLock) -> (Errno) {
  863. when size_of(int) == 4 {
  864. ret := syscall(SYS_fcntl64, fd, cmd, lock)
  865. return Errno(-ret)
  866. } else {
  867. ret := syscall(SYS_fcntl, fd, cmd, lock)
  868. return Errno(-ret)
  869. }
  870. }
  871. fcntl_setlkw :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLKW, lock: ^FLock) -> (Errno) {
  872. when size_of(int) == 4 {
  873. ret := syscall(SYS_fcntl64, fd, cmd, lock)
  874. return Errno(-ret)
  875. } else {
  876. ret := syscall(SYS_fcntl, fd, cmd, lock)
  877. return Errno(-ret)
  878. }
  879. }
  880. fcntl_getlk :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETLK, lock: ^FLock) -> (Errno) {
  881. when size_of(int) == 4 {
  882. ret := syscall(SYS_fcntl64, fd, cmd, lock)
  883. return Errno(-ret)
  884. } else {
  885. ret := syscall(SYS_fcntl, fd, cmd, lock)
  886. return Errno(-ret)
  887. }
  888. }
  889. fcntl_getown_ex :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETOWN_EX, owner: ^F_Owner) -> (Errno) {
  890. ret := syscall(SYS_fcntl, fd, cmd, owner)
  891. return Errno(-ret)
  892. }
  893. fcntl_setown_ex :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETOWN_EX, owner: ^F_Owner) -> (Errno) {
  894. ret := syscall(SYS_fcntl, fd, cmd, owner)
  895. return Errno(-ret)
  896. }
  897. fcntl_getsig :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETSIG) -> (Signal, Errno) {
  898. ret := syscall(SYS_fcntl, fd, cmd)
  899. return errno_unwrap(ret, Signal)
  900. }
  901. fcntl_setsig :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETSIG, sig: Signal) -> (Errno) {
  902. ret := syscall(SYS_fcntl, fd, cmd, sig)
  903. return Errno(-ret)
  904. }
  905. fcntl_setlease :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETLEASE, lease: FD_Lease) -> (Errno) {
  906. ret := syscall(SYS_fcntl, fd, cmd, lease)
  907. return Errno(-ret)
  908. }
  909. fcntl_getlease :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETLEASE) -> (FD_Lease, Errno) {
  910. ret := syscall(SYS_fcntl, fd, cmd)
  911. return errno_unwrap(ret, FD_Lease)
  912. }
  913. fcntl_notify :: proc "contextless" (fd: Fd, cmd: FCntl_Command_NOTIFY, notifications: FD_Notifications) -> (Errno) {
  914. ret := syscall(SYS_fcntl, fd, cmd)
  915. return Errno(-ret)
  916. }
  917. fcntl_setpipe_sz :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SETPIPE_SZ, sz: i32) -> (i32, Errno) {
  918. ret := syscall(SYS_fcntl, fd, cmd, sz)
  919. return errno_unwrap(ret, i32)
  920. }
  921. fcntl_getpipe_sz :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GETPIPE_SZ) -> (i32, Errno) {
  922. ret := syscall(SYS_fcntl, fd, cmd)
  923. return errno_unwrap(ret, i32)
  924. }
  925. fcntl_add_seals :: proc "contextless" (fd: Fd, cmd: FCntl_Command_ADD_SEALS, seal: Seal) -> (Errno) {
  926. ret := syscall(SYS_fcntl, fd, cmd, transmute(i32) seal)
  927. return Errno(-ret)
  928. }
  929. fcntl_get_seals :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_SEALS) -> (Seal, Errno) {
  930. ret := syscall(SYS_fcntl, fd, cmd)
  931. return errno_unwrap(i32(ret), Seal, Seal)
  932. }
  933. fcntl_get_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_RW_HINT, hint: ^RW_Hint) -> (Errno) {
  934. ret := syscall(SYS_fcntl, fd, cmd, hint)
  935. return Errno(-ret)
  936. }
  937. fcntl_set_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SET_RW_HINT, hint: ^RW_Hint) -> (Errno) {
  938. ret := syscall(SYS_fcntl, fd, cmd, hint)
  939. return Errno(-ret)
  940. }
  941. fcntl_get_file_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_GET_FILE_RW_HINT, hint: ^RW_Hint) -> (Errno) {
  942. ret := syscall(SYS_fcntl, fd, cmd, hint)
  943. return Errno(-ret)
  944. }
  945. fcntl_set_file_rw_hint :: proc "contextless" (fd: Fd, cmd: FCntl_Command_SET_FILE_RW_HINT, hint: ^RW_Hint) -> (Errno) {
  946. ret := syscall(SYS_fcntl, fd, cmd, hint)
  947. return Errno(-ret)
  948. }
  949. fcntl :: proc {
  950. fcntl_dupfd,
  951. fcntl_dupfd_cloexec,
  952. fcntl_getfd,
  953. fcntl_setfd,
  954. fcntl_getfl,
  955. fcntl_setfl,
  956. fcntl_setlk,
  957. fcntl_setlkw,
  958. fcntl_getlk,
  959. fcntl_getown_ex,
  960. fcntl_setown_ex,
  961. fcntl_getsig,
  962. fcntl_setsig,
  963. fcntl_setlease,
  964. fcntl_getlease,
  965. fcntl_notify,
  966. fcntl_setpipe_sz,
  967. fcntl_getpipe_sz,
  968. fcntl_add_seals,
  969. fcntl_get_seals,
  970. fcntl_get_rw_hint,
  971. fcntl_set_rw_hint,
  972. fcntl_get_file_rw_hint,
  973. fcntl_set_file_rw_hint,
  974. }
  975. /*
  976. Apply or remove advisory lock on an open file.
  977. Available since Linux 2.0.
  978. */
  979. flock :: proc "contextless" (fd: Fd, operation: FLock_Op) -> (Errno) {
  980. ret := syscall(SYS_flock, fd, transmute(i32) operation)
  981. return Errno(-ret)
  982. }
  983. /*
  984. Sync state of the file with the storage device.
  985. Available since Linux 1.0.
  986. */
  987. fsync :: proc "contextless" (fd: Fd) -> (Errno) {
  988. ret := syscall(SYS_fsync, fd)
  989. return Errno(-ret)
  990. }
  991. /*
  992. Synchronize the state of the file with the storage device. Similar to `fsync`,
  993. except does not flush the metadata.
  994. Available since Linux 2.0.
  995. */
  996. fdatasync :: proc "contextless" (fd: Fd) -> (Errno) {
  997. ret := syscall(SYS_fdatasync, fd)
  998. return Errno(-ret)
  999. }
  1000. /*
  1001. Truncate a file to specified length.
  1002. Available since Linux 1.0.
  1003. On 32-bit architectures available since Linux 2.4.
  1004. */
  1005. truncate :: proc "contextless" (name: cstring, length: i64) -> (Errno) {
  1006. when size_of(int) == 4 {
  1007. ret := syscall(SYS_truncate64, cast(rawptr) name, compat64_arg_pair(length))
  1008. return Errno(-ret)
  1009. } else {
  1010. ret := syscall(SYS_truncate, cast(rawptr) name, compat64_arg_pair(length))
  1011. return Errno(-ret)
  1012. }
  1013. }
  1014. /*
  1015. Truncate a file specified by file descriptor to specified length.
  1016. On 32-bit architectures available since 2.4.
  1017. */
  1018. ftruncate :: proc "contextless" (fd: Fd, length: i64) -> (Errno) {
  1019. when size_of(int) == 4 {
  1020. ret := syscall(SYS_ftruncate64, fd, compat64_arg_pair(length))
  1021. return Errno(-ret)
  1022. } else {
  1023. ret := syscall(SYS_ftruncate, fd, compat64_arg_pair(length))
  1024. return Errno(-ret)
  1025. }
  1026. }
  1027. /*
  1028. Retrieve the contents of the directory specified by dirfd.
  1029. Returns the number of bytes written.
  1030. Available since Linux 2.4.
  1031. */
  1032. getdents :: proc "contextless" (dirfd: Fd, buf: []u8) -> (int, Errno) {
  1033. ret := syscall(SYS_getdents64, dirfd, raw_data(buf), len(buf))
  1034. return errno_unwrap(ret, int)
  1035. }
  1036. /*
  1037. Get current working directory.
  1038. Available since Linux 1.0.
  1039. */
  1040. getcwd :: proc "contextless" (buf: []u8) -> (int, Errno) {
  1041. ret := syscall(SYS_getcwd, raw_data(buf), len(buf))
  1042. return errno_unwrap(ret, int)
  1043. }
  1044. /*
  1045. Change working directory to the directory specified by path.
  1046. Available since Linux 1.0.
  1047. */
  1048. chdir :: proc "contextless" (path: cstring) -> (Errno) {
  1049. ret := syscall(SYS_chdir, cast(rawptr) path)
  1050. return Errno(-ret)
  1051. }
  1052. /*
  1053. Change working directory to the directory specified by dirfd.
  1054. Available since Linux 1.0.
  1055. */
  1056. fchdir :: proc "contextless" (fd: Fd) -> (Errno) {
  1057. ret := syscall(SYS_fchdir, fd)
  1058. return Errno(-ret)
  1059. }
  1060. /*
  1061. Rename (move) the file.
  1062. Available since Linux 1.0.
  1063. On ARM64 available since Linux 2.6.16.
  1064. */
  1065. rename :: proc "contextless" (old: cstring, new: cstring) -> (Errno) {
  1066. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1067. ret := syscall(SYS_renameat, AT_FDCWD, cast(rawptr) old, AT_FDCWD, cast(rawptr) new)
  1068. return Errno(-ret)
  1069. } else {
  1070. ret := syscall(SYS_rename, cast(rawptr) old, cast(rawptr) new)
  1071. return Errno(-ret)
  1072. }
  1073. }
  1074. /*
  1075. Creates a directory.
  1076. Available since Linux 1.0.
  1077. On ARM64 available since Linux 2.6.16.
  1078. */
  1079. mkdir :: proc "contextless" (name: cstring, mode: Mode) -> (Errno) {
  1080. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1081. ret := syscall(SYS_mkdirat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode)
  1082. return Errno(-ret)
  1083. } else {
  1084. ret := syscall(SYS_mkdir, cast(rawptr) name, transmute(u32) mode)
  1085. return Errno(-ret)
  1086. }
  1087. }
  1088. /*
  1089. Remove a directory specified by name.
  1090. Available since Linux 1.0.
  1091. On ARM64 available since Linux 2.6.16.
  1092. */
  1093. rmdir :: proc "contextless" (name: cstring) -> (Errno) {
  1094. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1095. ret := syscall(SYS_unlinkat, AT_FDCWD, cast(rawptr) name, transmute(i32) FD_Flags{.REMOVEDIR})
  1096. return Errno(-ret)
  1097. } else {
  1098. ret := syscall(SYS_rmdir, cast(rawptr) name)
  1099. return Errno(-ret)
  1100. }
  1101. }
  1102. /*
  1103. Create a file.
  1104. Available since Linux 1.0.
  1105. On ARM64 available since Linux 2.6.16.
  1106. */
  1107. creat :: proc "contextless" (name: cstring, mode: Mode) -> (Fd, Errno) {
  1108. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1109. return openat(AT_FDCWD, name, {.CREAT, .WRONLY,.TRUNC}, mode)
  1110. } else {
  1111. ret := syscall(SYS_creat, cast(rawptr) name, transmute(u32) mode)
  1112. return errno_unwrap(ret, Fd)
  1113. }
  1114. }
  1115. /*
  1116. Create a hard link on a file.
  1117. Available since Linux 1.0.
  1118. On ARM64 available since Linux 2.6.16.
  1119. */
  1120. link :: proc "contextless" (target: cstring, linkpath: cstring) -> (Errno) {
  1121. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1122. ret := syscall(SYS_linkat, AT_FDCWD, cast(rawptr) target, AT_FDCWD, cast(rawptr) linkpath, 0)
  1123. return Errno(-ret)
  1124. } else {
  1125. ret := syscall(SYS_link, cast(rawptr) target, cast(rawptr) linkpath)
  1126. return Errno(-ret)
  1127. }
  1128. }
  1129. /*
  1130. Delete a name, and possible a file it refers to.
  1131. Available since Linux 1.0.
  1132. On ARM64 available since Linux 2.6.16.
  1133. */
  1134. unlink :: proc "contextless" (name: cstring) -> (Errno) {
  1135. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1136. ret := syscall(SYS_unlinkat, AT_FDCWD, cast(rawptr) name, 0)
  1137. return Errno(-ret)
  1138. } else {
  1139. ret := syscall(SYS_unlink, cast(rawptr) name)
  1140. return Errno(-ret)
  1141. }
  1142. }
  1143. /*
  1144. Create a symbolic link.
  1145. Available since Linux 1.0.
  1146. On arm64 available since Linux 2.6.16.
  1147. */
  1148. symlink :: proc "contextless" (target: cstring, linkpath: cstring) -> (Errno) {
  1149. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1150. ret := syscall(SYS_symlinkat, cast(rawptr) target, AT_FDCWD, cast(rawptr) linkpath)
  1151. return Errno(-ret)
  1152. } else {
  1153. ret := syscall(SYS_symlink, cast(rawptr) target, cast(rawptr) linkpath)
  1154. return Errno(-ret)
  1155. }
  1156. }
  1157. /*
  1158. Read the value of a symbolic link.
  1159. Available since Linux 1.0.
  1160. On arm64 available since Linux 2.6.16.
  1161. */
  1162. readlink :: proc "contextless" (name: cstring, buf: []u8) -> (int, Errno) {
  1163. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1164. ret := syscall(SYS_readlinkat, AT_FDCWD, cast(rawptr) name, raw_data(buf), len(buf))
  1165. return errno_unwrap(ret, int)
  1166. } else {
  1167. ret := syscall(SYS_readlink, cast(rawptr) name, raw_data(buf), len(buf))
  1168. return errno_unwrap(ret, int)
  1169. }
  1170. }
  1171. /*
  1172. Change file permissions.
  1173. Available since Linux 1.0.
  1174. On ARM64 available since Linux 2.6.16.
  1175. */
  1176. chmod :: proc "contextless" (name: cstring, mode: Mode) -> (Errno) {
  1177. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1178. ret := syscall(SYS_fchmodat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode)
  1179. return Errno(-ret)
  1180. } else {
  1181. ret := syscall(SYS_chmod, cast(rawptr) name, transmute(u32) mode)
  1182. return Errno(-ret)
  1183. }
  1184. }
  1185. /*
  1186. Change file permissions through a file descriptor.
  1187. Available since Linux 1.0.
  1188. */
  1189. fchmod :: proc "contextless" (fd: Fd, mode: Mode) -> (Errno) {
  1190. ret := syscall(SYS_fchmod, fd, transmute(u32) mode)
  1191. return Errno(-ret)
  1192. }
  1193. /*
  1194. Change ownership of a file.
  1195. Available since Linux 2.2.
  1196. On 32-bit architectures available since Linux 2.4.
  1197. On ARM64 available since Linux 2.6.16.
  1198. */
  1199. chown :: proc "contextless" (name: cstring, uid: Uid, gid: Gid) -> (Errno) {
  1200. when size_of(int) == 4 {
  1201. ret := syscall(SYS_chown32, cast(rawptr) name, uid, gid)
  1202. return Errno(-ret)
  1203. } else when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1204. ret := syscall(SYS_fchownat, AT_FDCWD, cast(rawptr) name, uid, gid, 0)
  1205. return Errno(-ret)
  1206. } else {
  1207. ret := syscall(SYS_chown, cast(rawptr) name, uid, gid)
  1208. return Errno(-ret)
  1209. }
  1210. }
  1211. /*
  1212. Change ownership of a file by file descriptor.
  1213. Available since Linux 1.0.
  1214. On 32-bit architecvtures available since Linux 2.4.
  1215. */
  1216. fchown :: proc "contextless" (fd: Fd, uid: Uid, gid: Gid) -> (Errno) {
  1217. when size_of(int) == 4 {
  1218. ret := syscall(SYS_fchown32, fd, uid, gid)
  1219. return Errno(-ret)
  1220. } else {
  1221. ret := syscall(SYS_fchown, fd, uid, gid)
  1222. return Errno(-ret)
  1223. }
  1224. }
  1225. /*
  1226. Change ownership of a file. Unlike chown, if a file is a symlink dooesn't dereference it.
  1227. Available since Linux 1.0.
  1228. On 32-bit architectures available since Linux 2.4.
  1229. On ARM64 available since Linux 2.6.16.
  1230. */
  1231. lchown :: proc "contextless" (name: cstring, uid: Uid, gid: Gid) -> (Errno) {
  1232. when size_of(int) == 4 {
  1233. ret := syscall(SYS_lchown32, cast(rawptr) name, uid, gid)
  1234. return Errno(-ret)
  1235. } else when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1236. ret := syscall(SYS_fchownat, AT_FDCWD, cast(rawptr) name, uid, gid, transmute(i32) FD_Flags{.SYMLINK_NOFOLLOW})
  1237. return Errno(-ret)
  1238. } else {
  1239. ret := syscall(SYS_lchown, cast(rawptr) name, uid, gid)
  1240. return Errno(-ret)
  1241. }
  1242. }
  1243. /*
  1244. Set file mode creation mask.
  1245. Available since Linux 1.0.
  1246. */
  1247. umask :: proc "contextless" (mask: Mode) -> Mode {
  1248. ret := syscall(SYS_umask, transmute(u32) mask)
  1249. return transmute(Mode) cast(u32) ret
  1250. }
  1251. /*
  1252. Get current time.
  1253. Available since Linux 1.0.
  1254. */
  1255. gettimeofday :: proc "contextless" (tv: ^Time_Val) -> (Errno) {
  1256. ret := syscall(SYS_gettimeofday, tv)
  1257. return Errno(-ret)
  1258. }
  1259. /*
  1260. Get limits on resources.
  1261. Available since Linux 1.0.
  1262. */
  1263. getrlimit :: proc "contextless" (kind: RLimit_Kind, resource: ^RLimit) -> (Errno) {
  1264. ret := syscall(SYS_getrlimit, kind, resource)
  1265. return Errno(-ret)
  1266. }
  1267. /*
  1268. Get resource usage.
  1269. Available since Linux 1.0.
  1270. */
  1271. getrusage :: proc "contextless" (who: RUsage_Who, rusage: ^RUsage) -> (Errno) {
  1272. ret := syscall(SYS_getrusage, who, rusage)
  1273. return Errno(-ret)
  1274. }
  1275. /*
  1276. Get information about the system.
  1277. Available since Linux 1.0.
  1278. */
  1279. sysinfo :: proc "contextless" (sysinfo: ^Sys_Info) -> (Errno) {
  1280. ret := syscall(SYS_sysinfo, sysinfo)
  1281. return Errno(-ret)
  1282. }
  1283. /*
  1284. Get current process times.
  1285. Available since Linux 1.0.
  1286. */
  1287. times :: proc "contextless" (tms: ^Tms) -> (Errno) {
  1288. ret := syscall(SYS_times, cast(rawptr) tms)
  1289. return Errno(-ret)
  1290. }
  1291. ptrace_traceme :: proc "contextless" (rq: PTrace_Traceme_Type) -> (Errno) {
  1292. ret := syscall(SYS_ptrace, rq)
  1293. return Errno(-ret)
  1294. }
  1295. ptrace_peek :: proc "contextless" (rq: PTrace_Peek_Type, pid: Pid, addr: uintptr) -> (uint, Errno) {
  1296. ret := syscall(SYS_ptrace, rq, pid, addr)
  1297. return errno_unwrap(ret, uint)
  1298. }
  1299. ptrace_poke :: proc "contextless" (rq: PTrace_Poke_Type, pid: Pid, addr: uintptr, data: uint) -> (Errno) {
  1300. ret := syscall(SYS_ptrace, rq, pid, addr, data)
  1301. return Errno(-ret)
  1302. }
  1303. ptrace_getregs :: proc "contextless" (rq: PTrace_Getregs_Type, pid: Pid, buf: ^User_Regs) -> (Errno) {
  1304. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1305. return Errno(-ret)
  1306. }
  1307. ptrace_getfpregs :: proc "contextless" (rq: PTrace_Getfpregs_Type, pid: Pid, buf: ^User_FP_Regs) -> (Errno) {
  1308. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1309. return Errno(-ret)
  1310. }
  1311. ptrace_getfpxregs :: proc "contextless" (rq: PTrace_Getfpxregs_Type, pid: Pid, buf: ^User_FPX_Regs) -> (Errno) {
  1312. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1313. return Errno(-ret)
  1314. }
  1315. ptrace_setregs :: proc "contextless" (rq: PTrace_Setregs_Type, pid: Pid, buf: ^User_Regs) -> (Errno) {
  1316. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1317. return Errno(-ret)
  1318. }
  1319. ptrace_setfpregs :: proc "contextless" (rq: PTrace_Setfpregs_Type, pid: Pid, buf: ^User_FP_Regs) -> (Errno) {
  1320. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1321. return Errno(-ret)
  1322. }
  1323. ptrace_setfpxregs :: proc "contextless" (rq: PTrace_Setfpxregs_Type, pid: Pid, buf: ^User_FPX_Regs) -> (Errno) {
  1324. ret := syscall(SYS_ptrace, rq, pid, 0, buf)
  1325. return Errno(-ret)
  1326. }
  1327. ptrace_getregset :: proc "contextless" (rq: PTrace_Getregset_Type, pid: Pid, note: PTrace_Note_Type, buf: ^IO_Vec) -> (Errno) {
  1328. ret := syscall(SYS_ptrace, rq, pid, note, buf)
  1329. return Errno(-ret)
  1330. }
  1331. ptrace_setregset :: proc "contextless" (rq: PTrace_Setregset_Type, pid: Pid, note: PTrace_Note_Type, buf: ^IO_Vec) -> (Errno) {
  1332. ret := syscall(SYS_ptrace, rq, pid, note, buf)
  1333. return Errno(-ret)
  1334. }
  1335. ptrace_getsiginfo :: proc "contextless" (rq: PTrace_Getsiginfo_Type, pid: Pid, si: ^Sig_Info) -> (Errno) {
  1336. ret := syscall(SYS_ptrace, rq, pid, si)
  1337. return Errno(-ret)
  1338. }
  1339. ptrace_peeksiginfo :: proc "contextless" (rq: PTrace_Peeksiginfo_Type, pid: Pid, si: ^Sig_Info) -> (Errno) {
  1340. ret := syscall(SYS_ptrace, rq, pid, si)
  1341. return Errno(-ret)
  1342. }
  1343. ptrace_getsigmask :: proc "contextless" (rq: PTrace_Getsigmask_Type, pid: Pid, sigmask: ^Sig_Set) -> (Errno) {
  1344. ret := syscall(SYS_ptrace, rq, pid, size_of(Sig_Set), sigmask)
  1345. return Errno(-ret)
  1346. }
  1347. ptrace_setsigmask :: proc "contextless" (rq: PTrace_Setsigmask_Type, pid: Pid, sigmask: ^Sig_Set) -> (Errno) {
  1348. ret := syscall(SYS_ptrace, rq, pid, size_of(Sig_Set), sigmask)
  1349. return Errno(-ret)
  1350. }
  1351. ptrace_setoptions :: proc "contextless" (rq: PTrace_Setoptions_Type, pid: Pid, options: PTrace_Options) -> (Errno) {
  1352. ret := syscall(SYS_ptrace, rq, pid, 0, transmute(u32) options)
  1353. return Errno(-ret)
  1354. }
  1355. ptrace_geteventmsg :: proc "contextless" (rq: PTrace_Geteventmsg_Type, pid: Pid, msg: ^uint) -> (Errno) {
  1356. ret := syscall(SYS_ptrace, rq, pid, msg)
  1357. return Errno(-ret)
  1358. }
  1359. ptrace_cont :: proc "contextless" (rq: PTrace_Cont_Type, pid: Pid, sig: Signal) -> (Errno) {
  1360. ret := syscall(SYS_ptrace, rq, pid, sig)
  1361. return Errno(-ret)
  1362. }
  1363. ptrace_singlestep :: proc "contextless" (rq: PTrace_Singlestep_Type, pid: Pid, sig: Signal) -> (Errno) {
  1364. ret := syscall(SYS_ptrace, rq, pid, sig)
  1365. return Errno(-ret)
  1366. }
  1367. ptrace_syscall :: proc "contextless" (rq: PTrace_Syscall_Type, pid: Pid, sig: Signal) -> (Errno) {
  1368. ret := syscall(SYS_ptrace, rq, pid, sig)
  1369. return Errno(-ret)
  1370. }
  1371. ptrace_sysemu :: proc "contextless" (rq: PTrace_Sysemu_Type, pid: Pid, sig: Signal) -> (Errno) {
  1372. ret := syscall(SYS_ptrace, rq, pid, sig)
  1373. return Errno(-ret)
  1374. }
  1375. ptrace_sysemu_singlestep :: proc "contextless" (rq: PTrace_Sysemu_Singlestep_Type, pid: Pid, sig: Signal) -> (Errno) {
  1376. ret := syscall(SYS_ptrace, rq, pid, sig)
  1377. return Errno(-ret)
  1378. }
  1379. ptrace_listen :: proc "contextless" (rq: PTrace_Listen_Type, pid: Pid) -> (Errno) {
  1380. ret := syscall(SYS_ptrace, rq, pid)
  1381. return Errno(-ret)
  1382. }
  1383. ptrace_interrupt :: proc "contextless" (rq: PTrace_Interrupt_Type, pid: Pid) -> (Errno) {
  1384. ret := syscall(SYS_ptrace, rq, pid)
  1385. return Errno(-ret)
  1386. }
  1387. ptrace_attach :: proc "contextless" (rq: PTrace_Attach_Type, pid: Pid) -> (Errno) {
  1388. ret := syscall(SYS_ptrace, rq, pid)
  1389. return Errno(-ret)
  1390. }
  1391. ptrace_seize :: proc "contextless" (rq: PTrace_Seize_Type, pid: Pid, opt: PTrace_Options) -> (Errno) {
  1392. ret := syscall(SYS_ptrace, rq, pid, 0, transmute(u32) opt)
  1393. return Errno(-ret)
  1394. }
  1395. // TODO(flysand): ptrace_seccomp_get_filter
  1396. ptrace_detach :: proc "contextless" (rq: PTrace_Detach_Type, pid: Pid, sig: Signal) -> (Errno) {
  1397. ret := syscall(SYS_ptrace, rq, pid, 0, sig)
  1398. return Errno(-ret)
  1399. }
  1400. // TODO(flysand): ptrace_get_thread_area
  1401. // TODO(flysand): ptrace_set_thread_area
  1402. // TODO(flysand): ptrace_get_syscall_info
  1403. /*
  1404. Trace process.
  1405. */
  1406. ptrace :: proc {
  1407. ptrace_traceme,
  1408. ptrace_peek,
  1409. ptrace_poke,
  1410. ptrace_getregs,
  1411. ptrace_getfpregs,
  1412. ptrace_getfpxregs,
  1413. ptrace_setregs,
  1414. ptrace_setfpregs,
  1415. ptrace_setfpxregs,
  1416. ptrace_getregset,
  1417. ptrace_setregset,
  1418. ptrace_getsiginfo,
  1419. ptrace_peeksiginfo,
  1420. ptrace_getsigmask,
  1421. ptrace_setsigmask,
  1422. ptrace_setoptions,
  1423. ptrace_geteventmsg,
  1424. ptrace_cont,
  1425. ptrace_singlestep,
  1426. ptrace_syscall,
  1427. ptrace_sysemu,
  1428. ptrace_sysemu_singlestep,
  1429. ptrace_listen,
  1430. ptrace_interrupt,
  1431. ptrace_attach,
  1432. ptrace_seize,
  1433. ptrace_detach,
  1434. }
  1435. /*
  1436. Get real user ID.
  1437. Available since Linux 1.0.
  1438. On 32-bit platforms available since Linux 2.4.
  1439. */
  1440. getuid :: proc "contextless" () -> Uid {
  1441. when size_of(int) == 8 {
  1442. return cast(Uid) syscall(SYS_getuid)
  1443. } else {
  1444. return cast(Uid) syscall(SYS_getuid32)
  1445. }
  1446. }
  1447. /*
  1448. Read or clear kernel message ring buffer.
  1449. Available since Linux 1.0.
  1450. */
  1451. syslog :: proc "contextless" (act: Syslog_Action, buf: []u8) -> (int, Errno) {
  1452. ret := syscall(SYS_syslog, act, raw_data(buf), len(buf))
  1453. return errno_unwrap(ret, int)
  1454. }
  1455. /*
  1456. Get real group ID.
  1457. Available since Linux 1.0.
  1458. On 32-bit platforms available since Linux 2.4.
  1459. */
  1460. getgid :: proc "contextless" () -> Gid {
  1461. when size_of(int) == 8 {
  1462. return cast(Gid) syscall(SYS_getgid)
  1463. } else {
  1464. return cast(Gid) syscall(SYS_getgid32)
  1465. }
  1466. }
  1467. /*
  1468. Set effective User ID.
  1469. Available since Linux 1.0.
  1470. On 32-bit platforms available since Linux 2.4.
  1471. */
  1472. @(require_results)
  1473. setuid :: proc "contextless" (uid: Uid) -> (Errno) {
  1474. when size_of(int) == 8 {
  1475. ret := syscall(SYS_setuid, uid)
  1476. return Errno(-ret)
  1477. } else {
  1478. ret := syscall(SYS_setuid32, uid)
  1479. return Errno(-ret)
  1480. }
  1481. }
  1482. /*
  1483. Set effective group id.
  1484. If the process is privileged also sets real group id.
  1485. Available since Linux 1.0.
  1486. On 32-bit platforms available since Linux 2.4.
  1487. */
  1488. @(require_results)
  1489. setgid :: proc "contextless" (gid: Gid) -> (Errno) {
  1490. when size_of(int) == 8 {
  1491. ret := syscall(SYS_setgid, gid)
  1492. return Errno(-ret)
  1493. } else {
  1494. ret := syscall(SYS_setgid32, gid)
  1495. return Errno(-ret)
  1496. }
  1497. }
  1498. /*
  1499. Get effective user ID.
  1500. Available since Linux 1.0.
  1501. On 32-bit platforms available since Linux 2.4.
  1502. */
  1503. geteuid :: proc "contextless" () -> Uid {
  1504. when size_of(int) == 8 {
  1505. return cast(Uid) syscall(SYS_geteuid)
  1506. } else {
  1507. return cast(Uid) syscall(SYS_geteuid32)
  1508. }
  1509. }
  1510. /*
  1511. Get effective group ID.
  1512. Available since Linux 1.0.
  1513. On 32-bit platforms available since Linux 2.4.
  1514. */
  1515. getegid :: proc "contextless" () -> Gid {
  1516. when size_of(int) == 8 {
  1517. return cast(Gid) syscall(SYS_getegid)
  1518. } else {
  1519. return cast(Gid) syscall(SYS_getegid32)
  1520. }
  1521. }
  1522. /*
  1523. Set process group.
  1524. Available since Linux 1.0.
  1525. */
  1526. setpgid :: proc "contextless" (pid: Pid, pgid: Pid) -> (Errno) {
  1527. ret := syscall(SYS_setpgid, pid, pgid)
  1528. return Errno(-ret)
  1529. }
  1530. /*
  1531. Get the parent process ID.
  1532. Available since Linux 1.0.
  1533. */
  1534. getppid :: proc "contextless" () -> Pid {
  1535. return cast(Pid) syscall(SYS_getppid)
  1536. }
  1537. /*
  1538. Get process group.
  1539. Available since Linux 1.0.
  1540. */
  1541. getpgrp :: proc "contextless" () -> (Pid, Errno) {
  1542. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1543. ret := syscall(SYS_getpgid, 0)
  1544. return errno_unwrap(ret, Pid)
  1545. } else {
  1546. ret := syscall(SYS_getpgrp)
  1547. return errno_unwrap(ret, Pid)
  1548. }
  1549. }
  1550. /*
  1551. Create a session and set the process group ID.
  1552. Available since Linux 2.0.
  1553. */
  1554. setsid :: proc "contextless" () -> (Pid, Errno) {
  1555. ret := syscall(SYS_setsid)
  1556. return errno_unwrap(ret, Pid)
  1557. }
  1558. /*
  1559. Set real and/or effective user id.
  1560. If any of the arguments is -1, the corresponding id is not changed.
  1561. Available since Linux 1.0.
  1562. On 32-bit platforms available since Linux 2.4.
  1563. */
  1564. @(require_results)
  1565. setreuid :: proc "contextless" (real: Uid, effective: Uid) -> (Errno) {
  1566. when size_of(int) == 8 {
  1567. ret := syscall(SYS_setreuid, real, effective)
  1568. return Errno(-ret)
  1569. } else {
  1570. ret := syscall(SYS_setreuid32, real, effective)
  1571. return Errno(-ret)
  1572. }
  1573. }
  1574. /*
  1575. Set real and/or effective group id.
  1576. If any of the arguments is -1, the corresponding id is not changed.
  1577. Available since Linux 1.0.
  1578. On 32-bit platforms available since Linux 2.4.
  1579. */
  1580. @(require_results)
  1581. setregid :: proc "contextless" (real: Gid, effective: Gid) -> (Errno) {
  1582. when size_of(int) == 8 {
  1583. ret := syscall(SYS_setregid, real, effective)
  1584. return Errno(-ret)
  1585. } else {
  1586. ret := syscall(SYS_setregid32, real, effective)
  1587. return Errno(-ret)
  1588. }
  1589. }
  1590. /*
  1591. Get supplementary group IDs.
  1592. Available since Linux 1.0.
  1593. On 32-bit platforms available since Linux 2.4.
  1594. */
  1595. getgroups :: proc "contextless" (gids: []Gid) -> (int, Errno) {
  1596. when size_of(int) == 8 {
  1597. ret := syscall(SYS_getgroups, len(gids), raw_data(gids))
  1598. return errno_unwrap(ret, int)
  1599. } else {
  1600. ret := syscall(SYS_getgroups32, len(gids), raw_data(gids))
  1601. return errno_unwrap(ret, int)
  1602. }
  1603. }
  1604. /*
  1605. Set supplementary group IDs.
  1606. Available since Linux 1.0.
  1607. On 32-bit platforms available since Linux 2.4.
  1608. */
  1609. setgroups :: proc "contextless" (gids: []Gid) -> (Errno) {
  1610. when size_of(int) == 8 {
  1611. ret := syscall(SYS_setgroups, len(gids), raw_data(gids))
  1612. return Errno(-ret)
  1613. } else {
  1614. ret := syscall(SYS_setgroups32, len(gids), raw_data(gids))
  1615. return Errno(-ret)
  1616. }
  1617. }
  1618. /*
  1619. Set real, effective and/or saved user id.
  1620. If any of the arguments is -1, the corresponding id is not changed.
  1621. Available since Linux 2.2.
  1622. On 32-bit platforms available since Linux 2.4.
  1623. */
  1624. @(require_results)
  1625. setresuid :: proc "contextless" (real: Uid, effective: Uid, saved: Uid) -> (Errno) {
  1626. when size_of(int) == 8 {
  1627. ret := syscall(SYS_setresuid, real, effective, saved)
  1628. return Errno(-ret)
  1629. } else {
  1630. ret := syscall(SYS_setresuid32, real, effective, saved)
  1631. return Errno(-ret)
  1632. }
  1633. }
  1634. /*
  1635. Get real, effective and saved user id.
  1636. Available since Linux 2.2.
  1637. On 32-bit platforms available since Linux 2.4.
  1638. */
  1639. getresuid :: proc "contextless" (real: ^Uid, effective: ^Uid, saved: ^Uid) -> (Errno) {
  1640. when size_of(int) == 8 {
  1641. ret := syscall(SYS_getresuid, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
  1642. return Errno(-ret)
  1643. } else {
  1644. ret := syscall(SYS_getresuid32, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
  1645. return Errno(-ret)
  1646. }
  1647. }
  1648. /*
  1649. Set real, effective and/or saved group id.
  1650. If any of the arguments is -1, the corresponding id is not changed.
  1651. Available since Linux 2.2.
  1652. On 32-bit platforms available since Linux 2.4.
  1653. */
  1654. @(require_results)
  1655. setresgid :: proc "contextless" (real: Gid, effective: Gid, saved: Uid) -> (Errno) {
  1656. when size_of(int) == 8 {
  1657. ret := syscall(SYS_setresgid, real, effective, saved)
  1658. return Errno(-ret)
  1659. } else {
  1660. ret := syscall(SYS_setresgid32, real, effective, saved)
  1661. return Errno(-ret)
  1662. }
  1663. }
  1664. /*
  1665. Get real, effective and saved group id.
  1666. Available since Linux 2.2.
  1667. On 32-bit platforms available since Linux 2.4.
  1668. */
  1669. getresgid :: proc "contextless" (real: ^Gid, effective: ^Gid, saved: ^Gid) -> (Errno) {
  1670. when size_of(int) == 8 {
  1671. ret := syscall(SYS_getresgid, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
  1672. return Errno(-ret)
  1673. } else {
  1674. ret := syscall(SYS_getresgid32, cast(rawptr) real, cast(rawptr) effective, cast(rawptr) saved)
  1675. return Errno(-ret)
  1676. }
  1677. }
  1678. /*
  1679. Get process group.
  1680. Available since Linux 1.0.
  1681. */
  1682. getpgid :: proc "contextless" (pid: Pid) -> (Pid, Errno) {
  1683. ret := syscall(SYS_getpgid, pid)
  1684. return errno_unwrap(ret, Pid)
  1685. }
  1686. /*
  1687. Get session ID of the calling process.
  1688. Available since Linux 2.0.
  1689. */
  1690. getsid :: proc "contextless" (pid: Pid) -> (Pid, Errno) {
  1691. ret := syscall(SYS_getsid, pid)
  1692. return errno_unwrap(ret, Pid)
  1693. }
  1694. // TODO(flysand): capget
  1695. // TODO(flysand): capset
  1696. /*
  1697. Examine pending signals.
  1698. Available since Linux 2.2.
  1699. */
  1700. rt_sigpending :: proc "contextless" (sigs: ^Sig_Set) -> Errno {
  1701. ret := syscall(SYS_rt_sigpending, sigs, size_of(Sig_Set))
  1702. return Errno(-ret)
  1703. }
  1704. /*
  1705. Synchronously wait for queued signals.
  1706. Available since Linux 2.2.
  1707. */
  1708. rt_sigtimedwait :: proc "contextless" (sigs: ^Sig_Set, info: ^Sig_Info, time_sus: ^Time_Spec) -> (Signal, Errno) {
  1709. ret := syscall(SYS_rt_sigtimedwait, sigs, info, time_sus, size_of(Sig_Set))
  1710. return errno_unwrap(ret, Signal)
  1711. }
  1712. /*
  1713. Send signal information to a process.
  1714. Available since Linux 2.2.
  1715. */
  1716. rt_sigqueueinfo :: proc "contextless" (pid: Pid, sig: Signal, si: ^Sig_Info) -> (Errno) {
  1717. ret := syscall(SYS_rt_sigqueueinfo, pid, sig, si)
  1718. return Errno(-ret)
  1719. }
  1720. /*
  1721. Replace the signal mask for a value with the new mask until a signal is received.
  1722. Available since Linux 2.2.
  1723. */
  1724. rt_sigsuspend :: proc "contextless" (sigset: ^Sig_Set) -> Errno {
  1725. ret := syscall(SYS_rt_sigsuspend, sigset, size_of(Sig_Set))
  1726. return Errno(-ret)
  1727. }
  1728. /*
  1729. Set or get signal stack context.
  1730. Available since Linux 2.2.
  1731. */
  1732. sigaltstack :: proc "contextless" (stack: ^Sig_Stack, old_stack: ^Sig_Stack) -> (Errno) {
  1733. ret := syscall(SYS_sigaltstack, stack, old_stack)
  1734. return Errno(-ret)
  1735. }
  1736. /*
  1737. Create a special or ordinary file.
  1738. `mode` parameter contains both the the file mode and the type of the node to create.
  1739. -> Add one of S_IFSOCK, S_IFBLK, S_IFFIFO, S_IFCHR to mode.
  1740. Available since Linux 1.0.
  1741. On ARM64 available since Linux 2.6.16.
  1742. */
  1743. mknod :: proc "contextless" (name: cstring, mode: Mode, dev: Dev) -> (Errno) {
  1744. when ODIN_ARCH == .arm64 || ODIN_ARCH == .riscv64 {
  1745. ret := syscall(SYS_mknodat, AT_FDCWD, cast(rawptr) name, transmute(u32) mode, dev)
  1746. return Errno(-ret)
  1747. } else {
  1748. ret := syscall(SYS_mknod, cast(rawptr) name, transmute(u32) mode, dev)
  1749. return Errno(-ret)
  1750. }
  1751. }
  1752. /*
  1753. Set the process execution domain.
  1754. Available since Linux 1.2.
  1755. */
  1756. personality :: proc "contextless" (personality: uint) -> (uint, Errno) {
  1757. ret := syscall(SYS_personality, personality)
  1758. return errno_unwrap(ret, uint)
  1759. }
  1760. // TODO(flysand): ustat
  1761. /*
  1762. Query information about filesystem.
  1763. Available since Linux 1.0.
  1764. For 32-bit systems a different syscall is used that became available since 2.6.
  1765. */
  1766. statfs :: proc "contextless" (path: cstring, statfs: ^Stat_FS) -> (Errno) {
  1767. when size_of(int) == 8 {
  1768. ret := syscall(SYS_statfs, transmute(uintptr) path, statfs)
  1769. return Errno(-ret)
  1770. } else {
  1771. ret := syscall(SYS_statfs64, cast(rawptr) path, size_of(Stat_FS), statfs)
  1772. return Errno(-ret)
  1773. }
  1774. }
  1775. /*
  1776. Query information about filesystem by file descriptor.
  1777. Available since Linux 1.0.
  1778. For 32-bit systems a different syscall is used that became available since 2.6.
  1779. */
  1780. fstatfs :: proc "contextless" (fd: Fd, statfs: ^Stat_FS) -> (Errno) {
  1781. when size_of(int) == 8 {
  1782. ret := syscall(SYS_statfs, fd, statfs)
  1783. return Errno(-ret)
  1784. } else {
  1785. ret := syscall(SYS_statfs64, fd, size_of(Stat_FS), statfs)
  1786. return Errno(-ret)
  1787. }
  1788. }
  1789. // TODO(flysand): sysfs
  1790. /*
  1791. Get priority on user, process group or process.
  1792. Available since Linux 1.0.
  1793. */
  1794. getpriority :: proc "contextless" (which: Priority_Which, who: i32) -> (i32, Errno) {
  1795. ret := syscall(SYS_getpriority, which, who)
  1796. prio, err := errno_unwrap(ret, i32)
  1797. // NOTE(flysand): getpriority will return `20 - priority` to avoid returning
  1798. // negative priorities as errors
  1799. prio = 20 - prio
  1800. return prio, err
  1801. }
  1802. /*
  1803. Set priority on user, process group or process.
  1804. Available since Linux 1.0.
  1805. */
  1806. setpriority :: proc "contextless" (which: Priority_Which, who: i32, prio: i32) -> (Errno) {
  1807. ret := syscall(SYS_setpriority, which, who, prio)
  1808. return Errno(-ret)
  1809. }
  1810. // TODO(flysand): sched_setparam
  1811. // TODO(flysand): sched_getparam
  1812. // TODO(flysand): sched_setscheduler
  1813. // TODO(flysand): sched_getscheduler
  1814. // TODO(flysand): sched_get_priority_max
  1815. // TODO(flysand): sched_get_priority_min
  1816. // TODO(flysand): sched_rr_get_interval
  1817. /*
  1818. Lock and memory.
  1819. Available since Linux 2.0.
  1820. If flags specified, available since Linux 4.4.
  1821. */
  1822. mlock :: proc "contextless" (addr: rawptr, size: uint, flags: MLock_Flags = {}) -> (Errno) {
  1823. // Pretty darn recent syscall, better call simpler version if we can
  1824. if flags > {} {
  1825. ret := syscall(SYS_mlock2, addr, size, transmute(i32) flags)
  1826. return Errno(-ret)
  1827. } else {
  1828. ret := syscall(SYS_mlock, addr, size)
  1829. return Errno(-ret)
  1830. }
  1831. }
  1832. /*
  1833. Unlock memory.
  1834. Available since Linux 2.0.
  1835. */
  1836. munlock :: proc "contextless" (addr: rawptr, size: uint) -> (Errno) {
  1837. ret := syscall(SYS_munlock, addr, size)
  1838. return Errno(-ret)
  1839. }
  1840. /*
  1841. Lock all memory.
  1842. Available since Linux 2.0.
  1843. */
  1844. mlockall :: proc "contextless" (flags: MLock_Flags = {}) -> (Errno) {
  1845. ret := syscall(SYS_mlockall, transmute(i32) flags)
  1846. return Errno(-ret)
  1847. }
  1848. /*
  1849. Unlock all memory.
  1850. Available since Linux 2.0.
  1851. */
  1852. munlockall :: proc "contextless" () -> (Errno) {
  1853. ret := syscall(SYS_munlockall)
  1854. return Errno(-ret)
  1855. }
  1856. // TODO(flysand): vhangup
  1857. // TODO(flysand): modify_ldt
  1858. // TODO(flysand): pivot_root
  1859. // TODO(flysand): _sysctl
  1860. // TODO(flysand): prctl
  1861. // TODO(flysand): arch_prctl
  1862. // TODO(flysand): adj_timex
  1863. /*
  1864. Set limits on resources.
  1865. Available since Linux 1.0.
  1866. */
  1867. setrlimit :: proc "contextless" (kind: RLimit_Kind, resource: ^RLimit) -> (Errno) {
  1868. ret := syscall(SYS_setrlimit, kind, resource)
  1869. return Errno(-ret)
  1870. }
  1871. // TODO(flysand): sync
  1872. // TODO(flysand): acct
  1873. // TODO(flysand): settimeofday
  1874. // TODO(flysand): mount
  1875. // TODO(flysand): umount2
  1876. // TODO(flysand): swapon
  1877. // TODO(flysand): swapoff
  1878. // TODO(flysand): reboot
  1879. /*
  1880. Set hostname.
  1881. Note: to get the host name, use `uname` syscall.
  1882. Available since Linux 1.0.
  1883. */
  1884. sethostname :: proc "contextless" (hostname: string) -> (Errno) {
  1885. ret := syscall(SYS_sethostname, raw_data(hostname), len(hostname))
  1886. return Errno(-ret)
  1887. }
  1888. /*
  1889. Set domain name.
  1890. Note: to get the domain name, use `uname` syscall.
  1891. Available since Linux 2.2.
  1892. */
  1893. setdomainname :: proc "contextless" (name: string) -> (Errno) {
  1894. ret := syscall(SYS_setdomainname, raw_data(name), len(name))
  1895. return Errno(-ret)
  1896. }
  1897. // TODO(flysand): iopl
  1898. // TODO(flysand): ioperm
  1899. // TODO(flysand): init_module
  1900. // TODO(flysand): delete_module
  1901. // TODO(flysand): quotactl
  1902. // TODO(flysand): nfsservctl
  1903. // TODO(flysand): getpmsg
  1904. // TODO(flysand): putpmsg
  1905. // TODO(flysand): afs_syscall
  1906. // TODO(flysand): tuxcall
  1907. // TODO(flysand): security
  1908. /*
  1909. Returns the thread ID of the current process
  1910. This is what the kernel calls "pid".
  1911. Let me insert a tiny rant here, this terminology is confusing:
  1912. sometimes pid refers to a thread, and other times it refers
  1913. to a thread group (process group?)
  1914. Anyway, this syscall is available since Linux 1.0
  1915. */
  1916. gettid :: proc "contextless" () -> Pid {
  1917. return cast(Pid) syscall(SYS_gettid)
  1918. }
  1919. // TODO(flysand): readahead
  1920. // TODO(flysand): setxattr
  1921. // TODO(flysand): lsetxattr
  1922. // TODO(flysand): fsetxattr
  1923. // TODO(flysand): getxattr
  1924. // TODO(flysand): lgetxattr
  1925. // TODO(flysand): fgetxattr
  1926. // TODO(flysand): listxattr
  1927. // TODO(flysand): llistxattr
  1928. // TODO(flysand): flistxattr
  1929. // TODO(flysand): removexattr
  1930. // TODO(flysand): lremovexattr
  1931. // TODO(flysand): fremovexattr
  1932. /*
  1933. Get current time in seconds.
  1934. Available since Linux 1.0.
  1935. */
  1936. time :: proc "contextless" (tloc: ^uint) -> (Errno) {
  1937. when ODIN_ARCH != .arm64 && ODIN_ARCH != .riscv64 {
  1938. ret := syscall(SYS_time, tloc)
  1939. return Errno(-ret)
  1940. } else {
  1941. ts: Time_Spec
  1942. ret := syscall(SYS_clock_gettime, Clock_Id.REALTIME, &ts)
  1943. tloc^ = ts.time_sec
  1944. return Errno(-ret)
  1945. }
  1946. }
  1947. /*
  1948. Wait on a futex until it's signaled.
  1949. */
  1950. futex_wait :: proc "contextless" (futex: ^Futex, op: Futex_Wait_Type, flags: Futex_Flags, val: u32, timeout: ^Time_Spec = nil) -> (Errno) {
  1951. futex_flags := cast(u32) op + transmute(u32) flags
  1952. ret := syscall(SYS_futex, futex, futex_flags, val, timeout)
  1953. return Errno(-ret)
  1954. }
  1955. /*
  1956. Wake up other threads on a futex
  1957. n_wakeup specifies the number of processes to wakeup. Specify max(i32) to wake up all processes waiting
  1958. */
  1959. futex_wake :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Type, flags: Futex_Flags, n_wakeup: i32) -> (int, Errno) {
  1960. futex_flags := cast(u32) op + transmute(u32) flags
  1961. ret := syscall(SYS_futex, futex, futex_flags, n_wakeup)
  1962. return errno_unwrap(ret, int)
  1963. }
  1964. // NOTE(flysand): futex_fd is racy, so not implemented
  1965. /*
  1966. Requeues processes waiting on futex `futex` to wait on futex `requeue_futex`
  1967. `requeue_threshold` specifies the maximum amount of waiters to wake up, the rest of the waiters will be requeued
  1968. `requeue_max` specifies the maximum amount of waiters that are required at `requeue_futex`
  1969. The operation blocks until the `requeue_max` requirement is satisfied
  1970. If the value of the mutex is not equal to `val`, fails with EAGAIN before any further checks
  1971. Returns the total number of waiters that have been woken up plus the number of waiters requeued.
  1972. */
  1973. futex_cmp_requeue :: proc "contextless" (futex: ^Futex, op: Futex_Cmp_Requeue_Type, flags: Futex_Flags, requeue_threshold: u32,
  1974. requeue_max: i32, requeue_futex: ^Futex, val: i32) -> (int, Errno) {
  1975. futex_flags := cast(u32) op + transmute(u32) flags
  1976. ret := syscall(SYS_futex, futex, futex_flags, requeue_threshold, requeue_max, requeue_futex, val)
  1977. return errno_unwrap(ret, int)
  1978. }
  1979. /*
  1980. See `futex_cmp_requeue`, this function does the same thing but doesn't check the value of the futex.
  1981. Returns the total number of waiters that have been woken up.
  1982. */
  1983. futex_requeue :: proc "contextless" (futex: ^Futex, op: Futex_Requeue_Type, flags: Futex_Flags, requeue_threshold: u32,
  1984. requeue_max: i32, requeue_futex: ^Futex) -> (int, Errno) {
  1985. futex_flags := cast(u32) op + transmute(u32) flags
  1986. ret := syscall(SYS_futex, futex, futex_flags, requeue_threshold, requeue_max, requeue_futex)
  1987. return errno_unwrap(ret, int)
  1988. }
  1989. /*
  1990. Okay, for this one, see the man pages, the description for it is pretty long and very specific. It's sole.
  1991. purpose is to allow implementing conditional values sync primitive, it seems like.
  1992. */
  1993. futex_wake_op :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Op_Type, flags: Futex_Flags, wakeup: i32,
  1994. dst_wakeup, dst: ^Futex, futex_op: u32) -> (int, Errno) {
  1995. futex_flags := cast(u32) op + transmute(u32) flags
  1996. ret := syscall(SYS_futex, futex, futex_flags, wakeup, dst_wakeup, dst, futex_op)
  1997. return errno_unwrap(ret, int)
  1998. }
  1999. /*
  2000. Same as wait, but mask specifies bits that must be equal for the mutex to wake up.
  2001. */
  2002. futex_wait_bitset :: proc "contextless" (futex: ^Futex, op: Futex_Wait_Bitset_Type, flags: Futex_Flags, val: u32,
  2003. timeout: ^Time_Spec, mask: u32) -> (int, Errno) {
  2004. futex_flags := cast(u32) op + transmute(u32) flags
  2005. ret := syscall(SYS_futex, futex, futex_flags, val, timeout, 0, mask)
  2006. return errno_unwrap(ret, int)
  2007. }
  2008. /*
  2009. Wake up on bitset.
  2010. */
  2011. futex_wake_bitset :: proc "contextless" (futex: ^Futex, op: Futex_Wake_Bitset_Type, flags: Futex_Flags, n_wakeup: u32, mask: u32) -> (int, Errno) {
  2012. futex_flags := cast(u32) op + transmute(u32) flags
  2013. ret := syscall(SYS_futex, futex, futex_flags, n_wakeup, 0, 0, mask)
  2014. return errno_unwrap(ret, int)
  2015. }
  2016. // TODO(flysand): Priority inheritance (PI) futicees
  2017. futex :: proc{
  2018. futex_wait,
  2019. futex_wake,
  2020. futex_cmp_requeue,
  2021. futex_requeue,
  2022. futex_wake_op,
  2023. futex_wait_bitset,
  2024. futex_wake_bitset,
  2025. }
  2026. // TODO(flysand): sched_setaffinity
  2027. // TODO(flysand): sched_getaffinity
  2028. // TODO(flysand): set_thread_area
  2029. // TODO(flysand): io_setup
  2030. // TODO(flysand): io_destroy
  2031. // TODO(flysand): io_getevents
  2032. // TODO(flysand): io_submit
  2033. // TODO(flysand): io_cancel
  2034. // TODO(flysand): get_thread_area
  2035. // TODO(flysand): lookup_dcookie
  2036. /*
  2037. Open an epoll file descriptor.
  2038. The `size` argument is ignored but must be greater than zero.
  2039. Available since Linux 2.6.
  2040. */
  2041. epoll_create :: proc(size: i32 = 1) -> (Fd, Errno) {
  2042. when ODIN_ARCH != .arm64 && ODIN_ARCH != .riscv64 {
  2043. ret := syscall(SYS_epoll_create, i32(1))
  2044. return errno_unwrap(ret, Fd)
  2045. } else {
  2046. ret := syscall(SYS_epoll_create1, i32(0))
  2047. return errno_unwrap(ret, Fd)
  2048. }
  2049. }
  2050. // TODO(flysand): remap_file_pages
  2051. /*
  2052. Set the address of the futex that's gonna be waken when.
  2053. current thread terminates.
  2054. Available since Linux 2.6.
  2055. */
  2056. set_tid_address :: proc "contextless" (tidptr: ^u32) {
  2057. syscall(SYS_set_tid_address, tidptr)
  2058. }
  2059. // TODO(flysand): semtimedop
  2060. // TODO(flysand): fadvise64
  2061. /*
  2062. Create POSIX per-process timer.
  2063. Available since Linux 2.6.
  2064. */
  2065. timer_create :: proc "contextless" (clock_id: Clock_Id, sigevent: ^Sig_Event, timer: ^Timer) -> (Errno) {
  2066. ret := syscall(SYS_timer_create, clock_id, sigevent, timer)
  2067. return Errno(-ret)
  2068. }
  2069. /*
  2070. Get the state of the POSIX per-process timer.
  2071. Available since Linux 2.6.
  2072. */
  2073. timer_gettime :: proc "contextless" (timer: Timer, curr_value: ^ITimer_Spec) -> (Errno) {
  2074. ret := syscall(SYS_timer_gettime, timer, curr_value)
  2075. return Errno(-ret)
  2076. }
  2077. /*
  2078. Arm/disarm the state of the POSIX per-process timer.
  2079. Available since Linux 2.6.
  2080. */
  2081. timer_settime :: proc "contextless" (timer: Timer, flags: ITimer_Flags, #no_alias new_value, old_value: ^ITimer_Spec) -> (Errno) {
  2082. ret := syscall(SYS_timer_settime, timer, transmute(u32) flags, new_value, old_value)
  2083. return Errno(-ret)
  2084. }
  2085. /*
  2086. Get overrun count of the POSIX per-process timer.
  2087. Available since Linux 2.6.
  2088. */
  2089. timer_getoverrun :: proc "contextless" (timer: Timer) -> (int, Errno) {
  2090. ret := syscall(SYS_timer_getoverrun, timer)
  2091. return errno_unwrap(ret, int)
  2092. }
  2093. /*
  2094. Delete a POSIX per-process timer.
  2095. Available since Linux 2.6.
  2096. */
  2097. timer_delete :: proc "contextless" (timer: Timer) -> (Errno) {
  2098. ret := syscall(SYS_timer_delete, timer)
  2099. return Errno(-ret)
  2100. }
  2101. /*
  2102. Set the time of the specified clock.
  2103. Available since Linux 2.6.
  2104. */
  2105. clock_settime :: proc "contextless" (clock: Clock_Id, ts: ^Time_Spec) -> (Errno) {
  2106. ret := syscall(SYS_clock_settime, clock, ts)
  2107. return Errno(-ret)
  2108. }
  2109. /*
  2110. Retrieve the time of the specified clock.
  2111. Available since Linux 2.6.
  2112. */
  2113. clock_gettime :: proc "contextless" (clock: Clock_Id) -> (ts: Time_Spec, err: Errno) {
  2114. ret := syscall(SYS_clock_gettime, clock, &ts)
  2115. err = Errno(-ret)
  2116. return
  2117. }
  2118. /*
  2119. Finds the resolution of the specified clock.
  2120. Available since Linux 2.6.
  2121. */
  2122. clock_getres :: proc "contextless" (clock: Clock_Id) -> (res: Time_Spec, err: Errno) {
  2123. ret := syscall(SYS_clock_getres, clock, &res)
  2124. err = Errno(-ret)
  2125. return
  2126. }
  2127. /*
  2128. Sleep for an interval specified with nanosecond precision.
  2129. Available since Linux 2.6.
  2130. */
  2131. clock_nanosleep :: proc "contextless" (clock: Clock_Id, flags: ITimer_Flags, request: ^Time_Spec, remain: ^Time_Spec) -> (Errno) {
  2132. ret := syscall(SYS_clock_nanosleep, clock, transmute(u32) flags, request, remain)
  2133. return Errno(-ret)
  2134. }
  2135. /*
  2136. Exit the thread group.
  2137. Available since Linux 2.6.
  2138. */
  2139. exit_group :: proc "contextless" (code: i32) -> ! {
  2140. syscall(SYS_exit_group, code)
  2141. unreachable()
  2142. }
  2143. /*
  2144. Wait for an I/O event on an epoll file descriptor.
  2145. `timeout` is specified in milliseconds.
  2146. Available since Linux 2.6.
  2147. */
  2148. epoll_wait :: proc(epfd: Fd, events: [^]EPoll_Event, count: i32, timeout: i32) -> (i32, Errno) {
  2149. when ODIN_ARCH != .arm64 && ODIN_ARCH != .riscv64 {
  2150. ret := syscall(SYS_epoll_wait, epfd, events, count, timeout)
  2151. return errno_unwrap(ret, i32)
  2152. } else {
  2153. // Convert milliseconds to nanosecond timespec
  2154. timeout_ns := Time_Spec {
  2155. time_sec = uint(timeout * 1000),
  2156. time_nsec = 0,
  2157. }
  2158. ret := syscall(SYS_epoll_pwait, epfd, events, count, &timeout_ns, rawptr(nil))
  2159. return errno_unwrap(ret, i32)
  2160. }
  2161. }
  2162. /*
  2163. Control interface for an epoll file descriptor.
  2164. Available since Linux 2.6.
  2165. */
  2166. epoll_ctl :: proc(epfd: Fd, op: EPoll_Ctl_Opcode, fd: Fd, event: ^EPoll_Event) -> (Errno) {
  2167. ret := syscall(SYS_epoll_ctl, epfd, op, fd, event)
  2168. return Errno(-ret)
  2169. }
  2170. /*
  2171. Send a signal to a specific thread in a thread group.
  2172. Available since Linux 2.6.
  2173. */
  2174. tgkill :: proc "contextless" (tgid, tid: Pid, sig: Signal) -> (Errno) {
  2175. ret := syscall(SYS_tgkill, tgid, tid, sig)
  2176. return Errno(-ret)
  2177. }
  2178. // TODO(flysand): utimes
  2179. // TODO(flysand): vserver
  2180. // TODO(flysand): mbind
  2181. // TODO(flysand): set_mempolicy
  2182. // TODO(flysand): get_mempolicy
  2183. // TODO(flysand): mq_open
  2184. // TODO(flysand): mq_unlink
  2185. // TODO(flysand): mq_timedsend
  2186. // TODO(flysand): mq_timedreceive
  2187. // TODO(flysand): mq_notify
  2188. // TODO(flysand): mq_getsetattr
  2189. // TODO(flysand): kexec_load
  2190. /*
  2191. Wait on process, process group or pid file descriptor.
  2192. Available since Linux 2.6.10.
  2193. */
  2194. waitid :: proc "contextless" (id_type: Id_Type, id: Id, sig_info: ^Sig_Info, options: Wait_Options, rusage: ^RUsage) -> (Errno) {
  2195. ret := syscall(SYS_waitid, id_type, id, sig_info, transmute(i32) options, rusage)
  2196. return Errno(-ret)
  2197. }
  2198. // TODO(flysand): add_key
  2199. // TODO(flysand): request_key
  2200. // TODO(flysand): keyctl
  2201. // TODO(flysand): ioprio_set
  2202. // TODO(flysand): ioprio_get
  2203. // TODO(flysand): inotify_init
  2204. // TODO(flysand): inotify_add_watch
  2205. // TODO(flysand): inotify_rm_watch
  2206. // TODO(flysand): migrate_pages
  2207. /*
  2208. Open file at the specified file descriptor.
  2209. Available since Linux 2.6.16.
  2210. */
  2211. openat :: proc "contextless" (fd: Fd, name: cstring, flags: Open_Flags, mode: Mode = {}) -> (Fd, Errno) {
  2212. ret := syscall(SYS_openat, fd, transmute(uintptr) name, transmute(u32) flags, transmute(u32) mode)
  2213. return errno_unwrap(ret, Fd)
  2214. }
  2215. /*
  2216. Create a directory relative to specified dirfd.
  2217. Available since Linux 2.6.16.
  2218. */
  2219. mkdirat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode) -> (Errno) {
  2220. ret := syscall(SYS_mkdirat, dirfd, cast(rawptr) name, transmute(u32) mode)
  2221. return Errno(-ret)
  2222. }
  2223. /*
  2224. Create a special or ordinary file wrt given directory specified by dirfd.
  2225. Available since Linux 2.6.16.
  2226. */
  2227. mknodat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode, dev: Dev) -> (Errno) {
  2228. ret := syscall(SYS_mknodat, dirfd, cast(rawptr) name, transmute(u32) mode, dev)
  2229. return Errno(-ret)
  2230. }
  2231. /*
  2232. Change the ownership of the file specified relative to directory.
  2233. Available since Linux 2.6.16.
  2234. */
  2235. fchownat :: proc "contextless" (dirfd: Fd, name: cstring, uid: Uid, gid: Gid) -> (Errno) {
  2236. ret := syscall(SYS_fchownat, dirfd, cast(rawptr) name, uid, gid)
  2237. return Errno(-ret)
  2238. }
  2239. /*
  2240. Get information about a file at a specific directory.
  2241. Available since Linux 2.6.16.
  2242. */
  2243. fstatat :: proc "contextless" (dirfd: Fd, name: cstring, stat: ^Stat, flags: FD_Flags) -> (Errno) {
  2244. when size_of(int) == 4 {
  2245. ret := syscall(SYS_fstatat64, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
  2246. return Errno(-ret)
  2247. } else when ODIN_ARCH == .amd64 {
  2248. ret := syscall(SYS_newfstatat, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
  2249. return Errno(-ret)
  2250. } else {
  2251. ret := syscall(SYS_fstatat, dirfd, cast(rawptr) name, stat, transmute(i32) flags)
  2252. return Errno(-ret)
  2253. }
  2254. }
  2255. /*
  2256. Remove a directory entry relative to a directory file descriptor.
  2257. Available since Linux 2.6.16.
  2258. */
  2259. unlinkat :: proc "contextless" (dirfd: Fd, name: cstring, flags: FD_Flags) -> (Errno) {
  2260. ret := syscall(SYS_unlinkat, dirfd, cast(rawptr) name, transmute(i32) flags)
  2261. return Errno(-ret)
  2262. }
  2263. /*
  2264. Rename the file with names relative to the specified dirfd's.
  2265. Available since Linux 2.6.16.
  2266. */
  2267. renameat :: proc "contextless" (oldfd: Fd, old: cstring, newfd: Fd, new: cstring) -> (Errno) {
  2268. ret := syscall(SYS_renameat, oldfd, cast(rawptr) old, newfd, cast(rawptr) new)
  2269. return Errno(-ret)
  2270. }
  2271. /*
  2272. Creates a hard link on a file relative to specified dirfd.
  2273. Available since Linux 2.6.16.
  2274. */
  2275. linkat :: proc "contextless" (target_dirfd: Fd, oldpath: cstring, link_dirfd: Fd, link: cstring, flags: FD_Flags) -> (Errno) {
  2276. ret := syscall(SYS_linkat, target_dirfd, cast(rawptr) oldpath, link_dirfd, cast(rawptr) link, transmute(i32) flags)
  2277. return Errno(-ret)
  2278. }
  2279. /*
  2280. Create a symbolic link at specified dirfd.
  2281. Available since Linux 2.6.16.
  2282. */
  2283. symlinkat :: proc "contextless" (target: cstring, dirfd: Fd, linkpath: cstring) -> (Errno) {
  2284. ret := syscall(SYS_symlinkat, cast(rawptr) target, dirfd, cast(rawptr) linkpath)
  2285. return Errno(-ret)
  2286. }
  2287. /*
  2288. Read the value of a symbolic link at given dirfd.
  2289. Available since Linux 2.6.16.
  2290. */
  2291. readlinkat :: proc "contextless" (dirfd: Fd, name: cstring, buf: []u8) -> (int, Errno) {
  2292. ret := syscall(SYS_readlinkat, dirfd, cast(rawptr) name, raw_data(buf), len(buf))
  2293. return errno_unwrap(ret, int)
  2294. }
  2295. /*
  2296. Change the file mode at a specified file descriptor.
  2297. Available since Linux 2.6.16.
  2298. */
  2299. fchmodat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode, flags: FD_Flags) -> (Errno) {
  2300. ret := syscall(SYS_fchmodat, cast(rawptr) name, transmute(u32) mode, transmute(i32) flags)
  2301. return Errno(-ret)
  2302. }
  2303. /*
  2304. Checks the user permissions for a file at specified dirfd.
  2305. Available since Linux 2.6.16.
  2306. */
  2307. faccessat :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode = F_OK) -> (Errno) {
  2308. ret := syscall(SYS_faccessat, dirfd, cast(rawptr) name, transmute(u32) mode)
  2309. return Errno(-ret)
  2310. }
  2311. /*
  2312. Wait for events on a file descriptor.
  2313. Available since Linux 2.6.16.
  2314. */
  2315. ppoll :: proc "contextless" (fds: []Poll_Fd, timeout: ^Time_Spec, sigmask: ^Sig_Set) -> (i32, Errno) {
  2316. when size_of(int) == 8 {
  2317. ret := syscall(SYS_ppoll, raw_data(fds), len(fds), timeout, sigmask, size_of(Sig_Set))
  2318. return errno_unwrap(ret, i32)
  2319. } else {
  2320. ret := syscall(SYS_ppoll_time64, raw_data(fds), len(fds), timeout, sigmask, size_of(Sig_Set))
  2321. return errno_unwrap(ret, i32)
  2322. }
  2323. }
  2324. // TODO(flysand): unshare
  2325. // TODO(flysand): set_robust_list
  2326. // TODO(flysand): get_robust_list
  2327. /*
  2328. Transfer the data between file descriptors.
  2329. Available since Linux 2.6.17.
  2330. */
  2331. splice :: proc "contextless" (fd_in: Fd, off_in: ^i64, fd_out: Fd, off_out: ^i64, len: uint, flags: Splice_Flags) -> (int, Errno) {
  2332. ret := syscall(SYS_splice, fd_in, off_in, fd_out, off_out, len, transmute(u32) flags)
  2333. return errno_unwrap(ret, int)
  2334. }
  2335. /*
  2336. Transfer the data between file descriptors.
  2337. Available since Linux 2.6.16.
  2338. */
  2339. tee :: proc "contextless" (fd_in: Fd, fd_out: Fd, len: uint, flags: Splice_Flags) -> (int, Errno) {
  2340. ret := syscall(SYS_tee, fd_in, fd_out, len, transmute(u32) flags)
  2341. return errno_unwrap(ret, int)
  2342. }
  2343. // TODO(flysand): sync_file_range
  2344. // TODO(flysand): vmsplice
  2345. // TODO(flysand): move_pages
  2346. /*
  2347. Change file timestamps with nanosecond precision.
  2348. **utimes** must point to an array of two `Time_Spec`'s. The "utime" is the
  2349. last access time, the second is last modification time.
  2350. Available since Linux 2.6.22.
  2351. */
  2352. utimensat :: proc "contextless" (dirfd: Fd, name: cstring, utimes: [^]Time_Spec, flags: FD_Flags) -> (Errno) {
  2353. ret := syscall(SYS_utimensat, dirfd, cast(rawptr) name, utimes, transmute(i32) flags)
  2354. return Errno(-ret)
  2355. }
  2356. /*
  2357. Wait for an I/O event on an epoll file descriptor.
  2358. Available since Linux 2.6.
  2359. */
  2360. epoll_pwait :: proc(epfd: Fd, events: [^]EPoll_Event, count: i32, timeout: i32, sigmask: ^Sig_Set) -> (i32, Errno) {
  2361. ret := syscall(SYS_epoll_pwait, epfd, events, count, timeout, sigmask)
  2362. return errno_unwrap(ret, i32)
  2363. }
  2364. // TODO(flysand): signalfd
  2365. // TODO(flysand): timerfd_create
  2366. // TODO(flysand): eventfd
  2367. // TODO(flysand): fallocate
  2368. // TODO(flysand): timerfd_settime
  2369. // TODO(flysand): timerfd_gettime
  2370. // TODO(flysand): accept4
  2371. // TODO(flysand): signalfd4
  2372. // TODO(flysand): eventfd2
  2373. epoll_create1 :: proc(flags: EPoll_Flags) -> (Fd, Errno) {
  2374. ret := syscall(SYS_epoll_create1, transmute(i32) flags)
  2375. return errno_unwrap(ret, Fd)
  2376. }
  2377. /*
  2378. Adjust an existing file descriptor to point to the same file as `old`.
  2379. In addition to dup2 allows to pass O_CLOEXEC flag.
  2380. Available since Linux 2.6.27.
  2381. */
  2382. dup3 :: proc "contextless" (old: Fd, new: Fd, flags: Open_Flags) -> (Fd, Errno) {
  2383. ret := syscall(SYS_dup3, old, new, transmute(i32) flags)
  2384. return errno_unwrap(ret, Fd)
  2385. }
  2386. // TODO(flysand): inotify_init1
  2387. // TODO(flysand): preadv
  2388. // TODO(flysand): pwritev
  2389. /// Send signal information to a thread
  2390. /// Available since Linux 2.2
  2391. rt_tgsigqueueinfo :: proc "contextless" (tgid: Pid, pid: Pid, sig: Signal, si: ^Sig_Info) -> (Errno) {
  2392. ret := syscall(SYS_rt_tgsigqueueinfo, tgid, pid, sig, si)
  2393. return Errno(-ret)
  2394. }
  2395. /*
  2396. Set up performance monitoring.
  2397. Available since Linux 2.6.31.
  2398. */
  2399. perf_event_open :: proc "contextless" (attr: ^Perf_Event_Attr, pid: Pid, cpu: int, group_fd: Fd, flags: Perf_Flags = {}) -> (Fd, Errno) {
  2400. ret := syscall(SYS_perf_event_open, attr, pid, cpu, group_fd, transmute(uint) flags)
  2401. return errno_unwrap(ret, Fd)
  2402. }
  2403. /*
  2404. Receive multiple messages from a socket.
  2405. Available since Linux 2.6.33.
  2406. */
  2407. recvmmsg :: proc "contextless" (sock: Fd, msg_vec: []MMsg_Hdr, flags: Socket_Msg) -> (int, Errno) {
  2408. ret := syscall(SYS_recvmmsg, sock, raw_data(msg_vec), len(msg_vec), transmute(i32) flags)
  2409. return errno_unwrap(ret, int)
  2410. }
  2411. // TODO(flysand): fanotify_init
  2412. // TODO(flysand): fanotify_mark
  2413. // TODO(flysand): prlimit64
  2414. // TODO(flysand): name_to_handle_at
  2415. // TODO(flysand): open_by_handle_at
  2416. // TODO(flysand): clock_adjtime
  2417. // TODO(flysand): syncfs
  2418. /*
  2419. Send multiple messages on a socket.
  2420. Available since Linux 3.0.
  2421. */
  2422. sendmmsg :: proc "contextless" (sock: Fd, msg_vec: []MMsg_Hdr, flags: Socket_Msg) -> (int, Errno) {
  2423. ret := syscall(SYS_sendmmsg, sock, raw_data(msg_vec), len(msg_vec), transmute(i32) flags)
  2424. return errno_unwrap(ret, int)
  2425. }
  2426. // TODO(flysand): setns
  2427. // TODO(flysand): getcpu
  2428. // TODO(flysand): process_vm_readv
  2429. // TODO(flysand): process_vm_writev
  2430. // TODO(flysand): kcmp
  2431. // TODO(flysand): finit_module
  2432. // TODO(flysand): sched_setattr
  2433. // TODO(flysand): sched_getattr
  2434. /*
  2435. Rename the file with names relative to the specified dirfd's with other options.
  2436. Available since Linux 3.15.
  2437. */
  2438. renameat2 :: proc "contextless" (oldfd: Fd, old: cstring, newfd: Fd, new: cstring, flags: Rename_Flags) -> (Errno) {
  2439. ret := syscall(SYS_renameat2, oldfd, cast(rawptr) old, newfd, cast(rawptr) new, transmute(u32) flags)
  2440. return Errno(-ret)
  2441. }
  2442. // TODO(flysand): seccomp
  2443. getrandom :: proc "contextless" (buf: []u8, flags: Get_Random_Flags) -> (int, Errno) {
  2444. ret := syscall(SYS_getrandom, raw_data(buf), len(buf), transmute(i32) flags)
  2445. return errno_unwrap(ret, int)
  2446. }
  2447. // TODO(flysand): memfd_create
  2448. // TODO(flysand): kexec_file_load
  2449. // TODO(flysand): bpf
  2450. /*
  2451. Execute program relative to a directory file descriptor.
  2452. Available since Linux 3.19.
  2453. */
  2454. execveat :: proc "contextless" (dirfd: Fd, name: cstring, argv: [^]cstring, envp: [^]cstring, flags: Execveat_Flags = {}) -> (Errno) {
  2455. ret := syscall(SYS_execveat, dirfd, cast(rawptr) name, cast(rawptr) argv, cast(rawptr) envp, transmute(i32) flags)
  2456. return Errno(-ret)
  2457. }
  2458. // TODO(flysand): userfaultfd
  2459. // TODO(flysand): membarrier
  2460. // TODO(flysand): mlock2
  2461. // TODO(flysand): copy_file_range
  2462. // TODO(flysand): preadv2
  2463. // TODO(flysand): pwritev2
  2464. // TODO(flysand): pkey_mprotect
  2465. // TODO(flysand): pkey_alloc
  2466. // TODO(flysand): pkey_free
  2467. /*
  2468. Query extended information about the file
  2469. The file can be specified as:
  2470. - absolute pathname: `dir` parameter is ignored
  2471. - relatvie pathname: `dir` parameter specifies the base directory's fd
  2472. - file descriptor: `AT_EMPTY_PATH` is passed in flags, pathname is empty, `dir` specifies the file descriptor
  2473. Available since Linux 4.11
  2474. */
  2475. statx :: proc "contextless" (dir: Fd, pathname: cstring, flags: FD_Flags, mask: Statx_Mask, statx: ^Statx) -> (Errno) {
  2476. ret := syscall(SYS_statx, dir, transmute(uintptr) pathname, transmute(i32) flags, transmute(u32) mask, statx)
  2477. return Errno(-ret)
  2478. }
  2479. // TODO(flysand): io_pgetevents
  2480. // TODO(flysand): rseq
  2481. // TODO(flysand): pidfd_send_signal
  2482. // TODO(flysand): io_uring_setup
  2483. // TODO(flysand): io_uring_enter
  2484. // TODO(flysand): io_uring_register
  2485. // TODO(flysand): open_tree
  2486. // TODO(flysand): move_mount
  2487. // TODO(flysand): fsopen
  2488. // TODO(flysand): fsconfig
  2489. // TODO(flysand): fsmount
  2490. // TODO(flysand): fspick
  2491. /*
  2492. Creates a new PID file descriptor.
  2493. The process identified by `pid` must be a pid group leader.
  2494. The returned `pidfd` has `CLOEXEC` semantics.
  2495. Available since Linux 5.3.
  2496. */
  2497. pidfd_open :: proc "contextless" (pid: Pid, flags: Pid_FD_Flags) -> (Pid_FD, Errno) {
  2498. ret := syscall(SYS_pidfd_open, pid, transmute(i32) flags)
  2499. return errno_unwrap(ret, Pid_FD)
  2500. }
  2501. // TODO(flysand): clone3 (probably not this PR)
  2502. /*
  2503. Close the range of files as an atomic operation.
  2504. The range of file descriptors is inclusive, and may contain invalid file descriptors.
  2505. Available since Linux 5.9.
  2506. */
  2507. close_range :: proc "contextless" (lo: Fd, hi: Fd, flags: Close_Range_Flags) -> (Errno) {
  2508. ret := syscall(SYS_close_range, lo, hi, transmute(u32) flags)
  2509. return Errno(-ret)
  2510. }
  2511. // TODO(flysand): openat2
  2512. /*
  2513. Get a file descriptor from another process.
  2514. - `fd` refers to a file descriptor number to get.
  2515. - `flags` must be zero.
  2516. Available since Linux 5.3.
  2517. */
  2518. pidfd_getfd :: proc "contextless" (pidfd: Pid_FD, fd: Fd, flags: i32 = 0) -> (Fd, Errno) {
  2519. ret := syscall(SYS_pidfd_getfd, pidfd, fd, flags)
  2520. return errno_unwrap(ret, Fd)
  2521. }
  2522. /*
  2523. Checks the user permissions for a file at specified dirfd (with flags).
  2524. Available since Linux 5.8.
  2525. */
  2526. faccessat2 :: proc "contextless" (dirfd: Fd, name: cstring, mode: Mode = F_OK, flags: FD_Flags = FD_Flags{}) -> (Errno) {
  2527. ret := syscall(SYS_faccessat2, dirfd, cast(rawptr) name, transmute(u32) mode, transmute(i32) flags)
  2528. return Errno(-ret)
  2529. }
  2530. // TODO(flysand): process_madvise
  2531. /*
  2532. Wait for an I/O event on an epoll file descriptor.
  2533. Available since Linux 2.6.
  2534. */
  2535. epoll_pwait2 :: proc(epfd: Fd, events: [^]EPoll_Event, count: i32, timeout: ^Time_Spec, sigmask: ^Sig_Set) -> (i32, Errno) {
  2536. ret := syscall(SYS_epoll_pwait2, epfd, events, count, timeout, sigmask)
  2537. return errno_unwrap(ret, i32)
  2538. }
  2539. // TODO(flysand): mount_setattr
  2540. // TODO(flysand): quotactl_fd
  2541. // TODO(flysand): landlock_create_ruleset
  2542. // TODO(flysand): landlock_add_rule
  2543. // TODO(flysand): landlock_restrict_self
  2544. // TODO(flysand): memfd_secret
  2545. // TODO(flysand): process_mrelease
  2546. // TODO(flysand): futex_waitv
  2547. // TODO(flysand): set_mempolicy_home_node
  2548. // TODO(flysand): cachestat
  2549. // TODO(flysand): fchmodat2
  2550. // TODO(flysand): map_shadow_stack