syscall_linux.go 53 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834
  1. // Copyright 2009 The Go Authors. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. // Linux system calls.
  5. // This file is compiled as ordinary Go code,
  6. // but it is also input to mksyscall,
  7. // which parses the //sys lines and generates system call stubs.
  8. // Note that sometimes we use a lowercase //sys name and
  9. // wrap it in our own nicer implementation.
  10. package unix
  11. import (
  12. "encoding/binary"
  13. "runtime"
  14. "syscall"
  15. "unsafe"
  16. )
  17. /*
  18. * Wrapped
  19. */
  20. func Access(path string, mode uint32) (err error) {
  21. return Faccessat(AT_FDCWD, path, mode, 0)
  22. }
  23. func Chmod(path string, mode uint32) (err error) {
  24. return Fchmodat(AT_FDCWD, path, mode, 0)
  25. }
  26. func Chown(path string, uid int, gid int) (err error) {
  27. return Fchownat(AT_FDCWD, path, uid, gid, 0)
  28. }
  29. func Creat(path string, mode uint32) (fd int, err error) {
  30. return Open(path, O_CREAT|O_WRONLY|O_TRUNC, mode)
  31. }
  32. //sys FanotifyInit(flags uint, event_f_flags uint) (fd int, err error)
  33. //sys fanotifyMark(fd int, flags uint, mask uint64, dirFd int, pathname *byte) (err error)
  34. func FanotifyMark(fd int, flags uint, mask uint64, dirFd int, pathname string) (err error) {
  35. if pathname == "" {
  36. return fanotifyMark(fd, flags, mask, dirFd, nil)
  37. }
  38. p, err := BytePtrFromString(pathname)
  39. if err != nil {
  40. return err
  41. }
  42. return fanotifyMark(fd, flags, mask, dirFd, p)
  43. }
  44. //sys fchmodat(dirfd int, path string, mode uint32) (err error)
  45. func Fchmodat(dirfd int, path string, mode uint32, flags int) (err error) {
  46. // Linux fchmodat doesn't support the flags parameter. Mimick glibc's behavior
  47. // and check the flags. Otherwise the mode would be applied to the symlink
  48. // destination which is not what the user expects.
  49. if flags&^AT_SYMLINK_NOFOLLOW != 0 {
  50. return EINVAL
  51. } else if flags&AT_SYMLINK_NOFOLLOW != 0 {
  52. return EOPNOTSUPP
  53. }
  54. return fchmodat(dirfd, path, mode)
  55. }
  56. //sys ioctl(fd int, req uint, arg uintptr) (err error)
  57. // ioctl itself should not be exposed directly, but additional get/set
  58. // functions for specific types are permissible.
  59. // IoctlSetPointerInt performs an ioctl operation which sets an
  60. // integer value on fd, using the specified request number. The ioctl
  61. // argument is called with a pointer to the integer value, rather than
  62. // passing the integer value directly.
  63. func IoctlSetPointerInt(fd int, req uint, value int) error {
  64. v := int32(value)
  65. return ioctl(fd, req, uintptr(unsafe.Pointer(&v)))
  66. }
  67. func IoctlSetRTCTime(fd int, value *RTCTime) error {
  68. err := ioctl(fd, RTC_SET_TIME, uintptr(unsafe.Pointer(value)))
  69. runtime.KeepAlive(value)
  70. return err
  71. }
  72. func IoctlGetUint32(fd int, req uint) (uint32, error) {
  73. var value uint32
  74. err := ioctl(fd, req, uintptr(unsafe.Pointer(&value)))
  75. return value, err
  76. }
  77. func IoctlGetRTCTime(fd int) (*RTCTime, error) {
  78. var value RTCTime
  79. err := ioctl(fd, RTC_RD_TIME, uintptr(unsafe.Pointer(&value)))
  80. return &value, err
  81. }
  82. //sys Linkat(olddirfd int, oldpath string, newdirfd int, newpath string, flags int) (err error)
  83. func Link(oldpath string, newpath string) (err error) {
  84. return Linkat(AT_FDCWD, oldpath, AT_FDCWD, newpath, 0)
  85. }
  86. func Mkdir(path string, mode uint32) (err error) {
  87. return Mkdirat(AT_FDCWD, path, mode)
  88. }
  89. func Mknod(path string, mode uint32, dev int) (err error) {
  90. return Mknodat(AT_FDCWD, path, mode, dev)
  91. }
  92. func Open(path string, mode int, perm uint32) (fd int, err error) {
  93. return openat(AT_FDCWD, path, mode|O_LARGEFILE, perm)
  94. }
  95. //sys openat(dirfd int, path string, flags int, mode uint32) (fd int, err error)
  96. func Openat(dirfd int, path string, flags int, mode uint32) (fd int, err error) {
  97. return openat(dirfd, path, flags|O_LARGEFILE, mode)
  98. }
  99. //sys ppoll(fds *PollFd, nfds int, timeout *Timespec, sigmask *Sigset_t) (n int, err error)
  100. func Ppoll(fds []PollFd, timeout *Timespec, sigmask *Sigset_t) (n int, err error) {
  101. if len(fds) == 0 {
  102. return ppoll(nil, 0, timeout, sigmask)
  103. }
  104. return ppoll(&fds[0], len(fds), timeout, sigmask)
  105. }
  106. //sys Readlinkat(dirfd int, path string, buf []byte) (n int, err error)
  107. func Readlink(path string, buf []byte) (n int, err error) {
  108. return Readlinkat(AT_FDCWD, path, buf)
  109. }
  110. func Rename(oldpath string, newpath string) (err error) {
  111. return Renameat(AT_FDCWD, oldpath, AT_FDCWD, newpath)
  112. }
  113. func Rmdir(path string) error {
  114. return Unlinkat(AT_FDCWD, path, AT_REMOVEDIR)
  115. }
  116. //sys Symlinkat(oldpath string, newdirfd int, newpath string) (err error)
  117. func Symlink(oldpath string, newpath string) (err error) {
  118. return Symlinkat(oldpath, AT_FDCWD, newpath)
  119. }
  120. func Unlink(path string) error {
  121. return Unlinkat(AT_FDCWD, path, 0)
  122. }
  123. //sys Unlinkat(dirfd int, path string, flags int) (err error)
  124. func Utimes(path string, tv []Timeval) error {
  125. if tv == nil {
  126. err := utimensat(AT_FDCWD, path, nil, 0)
  127. if err != ENOSYS {
  128. return err
  129. }
  130. return utimes(path, nil)
  131. }
  132. if len(tv) != 2 {
  133. return EINVAL
  134. }
  135. var ts [2]Timespec
  136. ts[0] = NsecToTimespec(TimevalToNsec(tv[0]))
  137. ts[1] = NsecToTimespec(TimevalToNsec(tv[1]))
  138. err := utimensat(AT_FDCWD, path, (*[2]Timespec)(unsafe.Pointer(&ts[0])), 0)
  139. if err != ENOSYS {
  140. return err
  141. }
  142. return utimes(path, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
  143. }
  144. //sys utimensat(dirfd int, path string, times *[2]Timespec, flags int) (err error)
  145. func UtimesNano(path string, ts []Timespec) error {
  146. if ts == nil {
  147. err := utimensat(AT_FDCWD, path, nil, 0)
  148. if err != ENOSYS {
  149. return err
  150. }
  151. return utimes(path, nil)
  152. }
  153. if len(ts) != 2 {
  154. return EINVAL
  155. }
  156. err := utimensat(AT_FDCWD, path, (*[2]Timespec)(unsafe.Pointer(&ts[0])), 0)
  157. if err != ENOSYS {
  158. return err
  159. }
  160. // If the utimensat syscall isn't available (utimensat was added to Linux
  161. // in 2.6.22, Released, 8 July 2007) then fall back to utimes
  162. var tv [2]Timeval
  163. for i := 0; i < 2; i++ {
  164. tv[i] = NsecToTimeval(TimespecToNsec(ts[i]))
  165. }
  166. return utimes(path, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
  167. }
  168. func UtimesNanoAt(dirfd int, path string, ts []Timespec, flags int) error {
  169. if ts == nil {
  170. return utimensat(dirfd, path, nil, flags)
  171. }
  172. if len(ts) != 2 {
  173. return EINVAL
  174. }
  175. return utimensat(dirfd, path, (*[2]Timespec)(unsafe.Pointer(&ts[0])), flags)
  176. }
  177. func Futimesat(dirfd int, path string, tv []Timeval) error {
  178. if tv == nil {
  179. return futimesat(dirfd, path, nil)
  180. }
  181. if len(tv) != 2 {
  182. return EINVAL
  183. }
  184. return futimesat(dirfd, path, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
  185. }
  186. func Futimes(fd int, tv []Timeval) (err error) {
  187. // Believe it or not, this is the best we can do on Linux
  188. // (and is what glibc does).
  189. return Utimes("/proc/self/fd/"+itoa(fd), tv)
  190. }
  191. const ImplementsGetwd = true
  192. //sys Getcwd(buf []byte) (n int, err error)
  193. func Getwd() (wd string, err error) {
  194. var buf [PathMax]byte
  195. n, err := Getcwd(buf[0:])
  196. if err != nil {
  197. return "", err
  198. }
  199. // Getcwd returns the number of bytes written to buf, including the NUL.
  200. if n < 1 || n > len(buf) || buf[n-1] != 0 {
  201. return "", EINVAL
  202. }
  203. return string(buf[0 : n-1]), nil
  204. }
  205. func Getgroups() (gids []int, err error) {
  206. n, err := getgroups(0, nil)
  207. if err != nil {
  208. return nil, err
  209. }
  210. if n == 0 {
  211. return nil, nil
  212. }
  213. // Sanity check group count. Max is 1<<16 on Linux.
  214. if n < 0 || n > 1<<20 {
  215. return nil, EINVAL
  216. }
  217. a := make([]_Gid_t, n)
  218. n, err = getgroups(n, &a[0])
  219. if err != nil {
  220. return nil, err
  221. }
  222. gids = make([]int, n)
  223. for i, v := range a[0:n] {
  224. gids[i] = int(v)
  225. }
  226. return
  227. }
  228. func Setgroups(gids []int) (err error) {
  229. if len(gids) == 0 {
  230. return setgroups(0, nil)
  231. }
  232. a := make([]_Gid_t, len(gids))
  233. for i, v := range gids {
  234. a[i] = _Gid_t(v)
  235. }
  236. return setgroups(len(a), &a[0])
  237. }
  238. type WaitStatus uint32
  239. // Wait status is 7 bits at bottom, either 0 (exited),
  240. // 0x7F (stopped), or a signal number that caused an exit.
  241. // The 0x80 bit is whether there was a core dump.
  242. // An extra number (exit code, signal causing a stop)
  243. // is in the high bits. At least that's the idea.
  244. // There are various irregularities. For example, the
  245. // "continued" status is 0xFFFF, distinguishing itself
  246. // from stopped via the core dump bit.
  247. const (
  248. mask = 0x7F
  249. core = 0x80
  250. exited = 0x00
  251. stopped = 0x7F
  252. shift = 8
  253. )
  254. func (w WaitStatus) Exited() bool { return w&mask == exited }
  255. func (w WaitStatus) Signaled() bool { return w&mask != stopped && w&mask != exited }
  256. func (w WaitStatus) Stopped() bool { return w&0xFF == stopped }
  257. func (w WaitStatus) Continued() bool { return w == 0xFFFF }
  258. func (w WaitStatus) CoreDump() bool { return w.Signaled() && w&core != 0 }
  259. func (w WaitStatus) ExitStatus() int {
  260. if !w.Exited() {
  261. return -1
  262. }
  263. return int(w>>shift) & 0xFF
  264. }
  265. func (w WaitStatus) Signal() syscall.Signal {
  266. if !w.Signaled() {
  267. return -1
  268. }
  269. return syscall.Signal(w & mask)
  270. }
  271. func (w WaitStatus) StopSignal() syscall.Signal {
  272. if !w.Stopped() {
  273. return -1
  274. }
  275. return syscall.Signal(w>>shift) & 0xFF
  276. }
  277. func (w WaitStatus) TrapCause() int {
  278. if w.StopSignal() != SIGTRAP {
  279. return -1
  280. }
  281. return int(w>>shift) >> 8
  282. }
  283. //sys wait4(pid int, wstatus *_C_int, options int, rusage *Rusage) (wpid int, err error)
  284. func Wait4(pid int, wstatus *WaitStatus, options int, rusage *Rusage) (wpid int, err error) {
  285. var status _C_int
  286. wpid, err = wait4(pid, &status, options, rusage)
  287. if wstatus != nil {
  288. *wstatus = WaitStatus(status)
  289. }
  290. return
  291. }
  292. func Mkfifo(path string, mode uint32) error {
  293. return Mknod(path, mode|S_IFIFO, 0)
  294. }
  295. func Mkfifoat(dirfd int, path string, mode uint32) error {
  296. return Mknodat(dirfd, path, mode|S_IFIFO, 0)
  297. }
  298. func (sa *SockaddrInet4) sockaddr() (unsafe.Pointer, _Socklen, error) {
  299. if sa.Port < 0 || sa.Port > 0xFFFF {
  300. return nil, 0, EINVAL
  301. }
  302. sa.raw.Family = AF_INET
  303. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  304. p[0] = byte(sa.Port >> 8)
  305. p[1] = byte(sa.Port)
  306. for i := 0; i < len(sa.Addr); i++ {
  307. sa.raw.Addr[i] = sa.Addr[i]
  308. }
  309. return unsafe.Pointer(&sa.raw), SizeofSockaddrInet4, nil
  310. }
  311. func (sa *SockaddrInet6) sockaddr() (unsafe.Pointer, _Socklen, error) {
  312. if sa.Port < 0 || sa.Port > 0xFFFF {
  313. return nil, 0, EINVAL
  314. }
  315. sa.raw.Family = AF_INET6
  316. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  317. p[0] = byte(sa.Port >> 8)
  318. p[1] = byte(sa.Port)
  319. sa.raw.Scope_id = sa.ZoneId
  320. for i := 0; i < len(sa.Addr); i++ {
  321. sa.raw.Addr[i] = sa.Addr[i]
  322. }
  323. return unsafe.Pointer(&sa.raw), SizeofSockaddrInet6, nil
  324. }
  325. func (sa *SockaddrUnix) sockaddr() (unsafe.Pointer, _Socklen, error) {
  326. name := sa.Name
  327. n := len(name)
  328. if n >= len(sa.raw.Path) {
  329. return nil, 0, EINVAL
  330. }
  331. sa.raw.Family = AF_UNIX
  332. for i := 0; i < n; i++ {
  333. sa.raw.Path[i] = int8(name[i])
  334. }
  335. // length is family (uint16), name, NUL.
  336. sl := _Socklen(2)
  337. if n > 0 {
  338. sl += _Socklen(n) + 1
  339. }
  340. if sa.raw.Path[0] == '@' {
  341. sa.raw.Path[0] = 0
  342. // Don't count trailing NUL for abstract address.
  343. sl--
  344. }
  345. return unsafe.Pointer(&sa.raw), sl, nil
  346. }
  347. // SockaddrLinklayer implements the Sockaddr interface for AF_PACKET type sockets.
  348. type SockaddrLinklayer struct {
  349. Protocol uint16
  350. Ifindex int
  351. Hatype uint16
  352. Pkttype uint8
  353. Halen uint8
  354. Addr [8]byte
  355. raw RawSockaddrLinklayer
  356. }
  357. func (sa *SockaddrLinklayer) sockaddr() (unsafe.Pointer, _Socklen, error) {
  358. if sa.Ifindex < 0 || sa.Ifindex > 0x7fffffff {
  359. return nil, 0, EINVAL
  360. }
  361. sa.raw.Family = AF_PACKET
  362. sa.raw.Protocol = sa.Protocol
  363. sa.raw.Ifindex = int32(sa.Ifindex)
  364. sa.raw.Hatype = sa.Hatype
  365. sa.raw.Pkttype = sa.Pkttype
  366. sa.raw.Halen = sa.Halen
  367. for i := 0; i < len(sa.Addr); i++ {
  368. sa.raw.Addr[i] = sa.Addr[i]
  369. }
  370. return unsafe.Pointer(&sa.raw), SizeofSockaddrLinklayer, nil
  371. }
  372. // SockaddrNetlink implements the Sockaddr interface for AF_NETLINK type sockets.
  373. type SockaddrNetlink struct {
  374. Family uint16
  375. Pad uint16
  376. Pid uint32
  377. Groups uint32
  378. raw RawSockaddrNetlink
  379. }
  380. func (sa *SockaddrNetlink) sockaddr() (unsafe.Pointer, _Socklen, error) {
  381. sa.raw.Family = AF_NETLINK
  382. sa.raw.Pad = sa.Pad
  383. sa.raw.Pid = sa.Pid
  384. sa.raw.Groups = sa.Groups
  385. return unsafe.Pointer(&sa.raw), SizeofSockaddrNetlink, nil
  386. }
  387. // SockaddrHCI implements the Sockaddr interface for AF_BLUETOOTH type sockets
  388. // using the HCI protocol.
  389. type SockaddrHCI struct {
  390. Dev uint16
  391. Channel uint16
  392. raw RawSockaddrHCI
  393. }
  394. func (sa *SockaddrHCI) sockaddr() (unsafe.Pointer, _Socklen, error) {
  395. sa.raw.Family = AF_BLUETOOTH
  396. sa.raw.Dev = sa.Dev
  397. sa.raw.Channel = sa.Channel
  398. return unsafe.Pointer(&sa.raw), SizeofSockaddrHCI, nil
  399. }
  400. // SockaddrL2 implements the Sockaddr interface for AF_BLUETOOTH type sockets
  401. // using the L2CAP protocol.
  402. type SockaddrL2 struct {
  403. PSM uint16
  404. CID uint16
  405. Addr [6]uint8
  406. AddrType uint8
  407. raw RawSockaddrL2
  408. }
  409. func (sa *SockaddrL2) sockaddr() (unsafe.Pointer, _Socklen, error) {
  410. sa.raw.Family = AF_BLUETOOTH
  411. psm := (*[2]byte)(unsafe.Pointer(&sa.raw.Psm))
  412. psm[0] = byte(sa.PSM)
  413. psm[1] = byte(sa.PSM >> 8)
  414. for i := 0; i < len(sa.Addr); i++ {
  415. sa.raw.Bdaddr[i] = sa.Addr[len(sa.Addr)-1-i]
  416. }
  417. cid := (*[2]byte)(unsafe.Pointer(&sa.raw.Cid))
  418. cid[0] = byte(sa.CID)
  419. cid[1] = byte(sa.CID >> 8)
  420. sa.raw.Bdaddr_type = sa.AddrType
  421. return unsafe.Pointer(&sa.raw), SizeofSockaddrL2, nil
  422. }
  423. // SockaddrRFCOMM implements the Sockaddr interface for AF_BLUETOOTH type sockets
  424. // using the RFCOMM protocol.
  425. //
  426. // Server example:
  427. //
  428. // fd, _ := Socket(AF_BLUETOOTH, SOCK_STREAM, BTPROTO_RFCOMM)
  429. // _ = unix.Bind(fd, &unix.SockaddrRFCOMM{
  430. // Channel: 1,
  431. // Addr: [6]uint8{0, 0, 0, 0, 0, 0}, // BDADDR_ANY or 00:00:00:00:00:00
  432. // })
  433. // _ = Listen(fd, 1)
  434. // nfd, sa, _ := Accept(fd)
  435. // fmt.Printf("conn addr=%v fd=%d", sa.(*unix.SockaddrRFCOMM).Addr, nfd)
  436. // Read(nfd, buf)
  437. //
  438. // Client example:
  439. //
  440. // fd, _ := Socket(AF_BLUETOOTH, SOCK_STREAM, BTPROTO_RFCOMM)
  441. // _ = Connect(fd, &SockaddrRFCOMM{
  442. // Channel: 1,
  443. // Addr: [6]byte{0x11, 0x22, 0x33, 0xaa, 0xbb, 0xcc}, // CC:BB:AA:33:22:11
  444. // })
  445. // Write(fd, []byte(`hello`))
  446. type SockaddrRFCOMM struct {
  447. // Addr represents a bluetooth address, byte ordering is little-endian.
  448. Addr [6]uint8
  449. // Channel is a designated bluetooth channel, only 1-30 are available for use.
  450. // Since Linux 2.6.7 and further zero value is the first available channel.
  451. Channel uint8
  452. raw RawSockaddrRFCOMM
  453. }
  454. func (sa *SockaddrRFCOMM) sockaddr() (unsafe.Pointer, _Socklen, error) {
  455. sa.raw.Family = AF_BLUETOOTH
  456. sa.raw.Channel = sa.Channel
  457. sa.raw.Bdaddr = sa.Addr
  458. return unsafe.Pointer(&sa.raw), SizeofSockaddrRFCOMM, nil
  459. }
  460. // SockaddrCAN implements the Sockaddr interface for AF_CAN type sockets.
  461. // The RxID and TxID fields are used for transport protocol addressing in
  462. // (CAN_TP16, CAN_TP20, CAN_MCNET, and CAN_ISOTP), they can be left with
  463. // zero values for CAN_RAW and CAN_BCM sockets as they have no meaning.
  464. //
  465. // The SockaddrCAN struct must be bound to the socket file descriptor
  466. // using Bind before the CAN socket can be used.
  467. //
  468. // // Read one raw CAN frame
  469. // fd, _ := Socket(AF_CAN, SOCK_RAW, CAN_RAW)
  470. // addr := &SockaddrCAN{Ifindex: index}
  471. // Bind(fd, addr)
  472. // frame := make([]byte, 16)
  473. // Read(fd, frame)
  474. //
  475. // The full SocketCAN documentation can be found in the linux kernel
  476. // archives at: https://www.kernel.org/doc/Documentation/networking/can.txt
  477. type SockaddrCAN struct {
  478. Ifindex int
  479. RxID uint32
  480. TxID uint32
  481. raw RawSockaddrCAN
  482. }
  483. func (sa *SockaddrCAN) sockaddr() (unsafe.Pointer, _Socklen, error) {
  484. if sa.Ifindex < 0 || sa.Ifindex > 0x7fffffff {
  485. return nil, 0, EINVAL
  486. }
  487. sa.raw.Family = AF_CAN
  488. sa.raw.Ifindex = int32(sa.Ifindex)
  489. rx := (*[4]byte)(unsafe.Pointer(&sa.RxID))
  490. for i := 0; i < 4; i++ {
  491. sa.raw.Addr[i] = rx[i]
  492. }
  493. tx := (*[4]byte)(unsafe.Pointer(&sa.TxID))
  494. for i := 0; i < 4; i++ {
  495. sa.raw.Addr[i+4] = tx[i]
  496. }
  497. return unsafe.Pointer(&sa.raw), SizeofSockaddrCAN, nil
  498. }
  499. // SockaddrALG implements the Sockaddr interface for AF_ALG type sockets.
  500. // SockaddrALG enables userspace access to the Linux kernel's cryptography
  501. // subsystem. The Type and Name fields specify which type of hash or cipher
  502. // should be used with a given socket.
  503. //
  504. // To create a file descriptor that provides access to a hash or cipher, both
  505. // Bind and Accept must be used. Once the setup process is complete, input
  506. // data can be written to the socket, processed by the kernel, and then read
  507. // back as hash output or ciphertext.
  508. //
  509. // Here is an example of using an AF_ALG socket with SHA1 hashing.
  510. // The initial socket setup process is as follows:
  511. //
  512. // // Open a socket to perform SHA1 hashing.
  513. // fd, _ := unix.Socket(unix.AF_ALG, unix.SOCK_SEQPACKET, 0)
  514. // addr := &unix.SockaddrALG{Type: "hash", Name: "sha1"}
  515. // unix.Bind(fd, addr)
  516. // // Note: unix.Accept does not work at this time; must invoke accept()
  517. // // manually using unix.Syscall.
  518. // hashfd, _, _ := unix.Syscall(unix.SYS_ACCEPT, uintptr(fd), 0, 0)
  519. //
  520. // Once a file descriptor has been returned from Accept, it may be used to
  521. // perform SHA1 hashing. The descriptor is not safe for concurrent use, but
  522. // may be re-used repeatedly with subsequent Write and Read operations.
  523. //
  524. // When hashing a small byte slice or string, a single Write and Read may
  525. // be used:
  526. //
  527. // // Assume hashfd is already configured using the setup process.
  528. // hash := os.NewFile(hashfd, "sha1")
  529. // // Hash an input string and read the results. Each Write discards
  530. // // previous hash state. Read always reads the current state.
  531. // b := make([]byte, 20)
  532. // for i := 0; i < 2; i++ {
  533. // io.WriteString(hash, "Hello, world.")
  534. // hash.Read(b)
  535. // fmt.Println(hex.EncodeToString(b))
  536. // }
  537. // // Output:
  538. // // 2ae01472317d1935a84797ec1983ae243fc6aa28
  539. // // 2ae01472317d1935a84797ec1983ae243fc6aa28
  540. //
  541. // For hashing larger byte slices, or byte streams such as those read from
  542. // a file or socket, use Sendto with MSG_MORE to instruct the kernel to update
  543. // the hash digest instead of creating a new one for a given chunk and finalizing it.
  544. //
  545. // // Assume hashfd and addr are already configured using the setup process.
  546. // hash := os.NewFile(hashfd, "sha1")
  547. // // Hash the contents of a file.
  548. // f, _ := os.Open("/tmp/linux-4.10-rc7.tar.xz")
  549. // b := make([]byte, 4096)
  550. // for {
  551. // n, err := f.Read(b)
  552. // if err == io.EOF {
  553. // break
  554. // }
  555. // unix.Sendto(hashfd, b[:n], unix.MSG_MORE, addr)
  556. // }
  557. // hash.Read(b)
  558. // fmt.Println(hex.EncodeToString(b))
  559. // // Output: 85cdcad0c06eef66f805ecce353bec9accbeecc5
  560. //
  561. // For more information, see: http://www.chronox.de/crypto-API/crypto/userspace-if.html.
  562. type SockaddrALG struct {
  563. Type string
  564. Name string
  565. Feature uint32
  566. Mask uint32
  567. raw RawSockaddrALG
  568. }
  569. func (sa *SockaddrALG) sockaddr() (unsafe.Pointer, _Socklen, error) {
  570. // Leave room for NUL byte terminator.
  571. if len(sa.Type) > 13 {
  572. return nil, 0, EINVAL
  573. }
  574. if len(sa.Name) > 63 {
  575. return nil, 0, EINVAL
  576. }
  577. sa.raw.Family = AF_ALG
  578. sa.raw.Feat = sa.Feature
  579. sa.raw.Mask = sa.Mask
  580. typ, err := ByteSliceFromString(sa.Type)
  581. if err != nil {
  582. return nil, 0, err
  583. }
  584. name, err := ByteSliceFromString(sa.Name)
  585. if err != nil {
  586. return nil, 0, err
  587. }
  588. copy(sa.raw.Type[:], typ)
  589. copy(sa.raw.Name[:], name)
  590. return unsafe.Pointer(&sa.raw), SizeofSockaddrALG, nil
  591. }
  592. // SockaddrVM implements the Sockaddr interface for AF_VSOCK type sockets.
  593. // SockaddrVM provides access to Linux VM sockets: a mechanism that enables
  594. // bidirectional communication between a hypervisor and its guest virtual
  595. // machines.
  596. type SockaddrVM struct {
  597. // CID and Port specify a context ID and port address for a VM socket.
  598. // Guests have a unique CID, and hosts may have a well-known CID of:
  599. // - VMADDR_CID_HYPERVISOR: refers to the hypervisor process.
  600. // - VMADDR_CID_HOST: refers to other processes on the host.
  601. CID uint32
  602. Port uint32
  603. raw RawSockaddrVM
  604. }
  605. func (sa *SockaddrVM) sockaddr() (unsafe.Pointer, _Socklen, error) {
  606. sa.raw.Family = AF_VSOCK
  607. sa.raw.Port = sa.Port
  608. sa.raw.Cid = sa.CID
  609. return unsafe.Pointer(&sa.raw), SizeofSockaddrVM, nil
  610. }
  611. type SockaddrXDP struct {
  612. Flags uint16
  613. Ifindex uint32
  614. QueueID uint32
  615. SharedUmemFD uint32
  616. raw RawSockaddrXDP
  617. }
  618. func (sa *SockaddrXDP) sockaddr() (unsafe.Pointer, _Socklen, error) {
  619. sa.raw.Family = AF_XDP
  620. sa.raw.Flags = sa.Flags
  621. sa.raw.Ifindex = sa.Ifindex
  622. sa.raw.Queue_id = sa.QueueID
  623. sa.raw.Shared_umem_fd = sa.SharedUmemFD
  624. return unsafe.Pointer(&sa.raw), SizeofSockaddrXDP, nil
  625. }
  626. // This constant mirrors the #define of PX_PROTO_OE in
  627. // linux/if_pppox.h. We're defining this by hand here instead of
  628. // autogenerating through mkerrors.sh because including
  629. // linux/if_pppox.h causes some declaration conflicts with other
  630. // includes (linux/if_pppox.h includes linux/in.h, which conflicts
  631. // with netinet/in.h). Given that we only need a single zero constant
  632. // out of that file, it's cleaner to just define it by hand here.
  633. const px_proto_oe = 0
  634. type SockaddrPPPoE struct {
  635. SID uint16
  636. Remote []byte
  637. Dev string
  638. raw RawSockaddrPPPoX
  639. }
  640. func (sa *SockaddrPPPoE) sockaddr() (unsafe.Pointer, _Socklen, error) {
  641. if len(sa.Remote) != 6 {
  642. return nil, 0, EINVAL
  643. }
  644. if len(sa.Dev) > IFNAMSIZ-1 {
  645. return nil, 0, EINVAL
  646. }
  647. *(*uint16)(unsafe.Pointer(&sa.raw[0])) = AF_PPPOX
  648. // This next field is in host-endian byte order. We can't use the
  649. // same unsafe pointer cast as above, because this value is not
  650. // 32-bit aligned and some architectures don't allow unaligned
  651. // access.
  652. //
  653. // However, the value of px_proto_oe is 0, so we can use
  654. // encoding/binary helpers to write the bytes without worrying
  655. // about the ordering.
  656. binary.BigEndian.PutUint32(sa.raw[2:6], px_proto_oe)
  657. // This field is deliberately big-endian, unlike the previous
  658. // one. The kernel expects SID to be in network byte order.
  659. binary.BigEndian.PutUint16(sa.raw[6:8], sa.SID)
  660. copy(sa.raw[8:14], sa.Remote)
  661. for i := 14; i < 14+IFNAMSIZ; i++ {
  662. sa.raw[i] = 0
  663. }
  664. copy(sa.raw[14:], sa.Dev)
  665. return unsafe.Pointer(&sa.raw), SizeofSockaddrPPPoX, nil
  666. }
  667. func anyToSockaddr(fd int, rsa *RawSockaddrAny) (Sockaddr, error) {
  668. switch rsa.Addr.Family {
  669. case AF_NETLINK:
  670. pp := (*RawSockaddrNetlink)(unsafe.Pointer(rsa))
  671. sa := new(SockaddrNetlink)
  672. sa.Family = pp.Family
  673. sa.Pad = pp.Pad
  674. sa.Pid = pp.Pid
  675. sa.Groups = pp.Groups
  676. return sa, nil
  677. case AF_PACKET:
  678. pp := (*RawSockaddrLinklayer)(unsafe.Pointer(rsa))
  679. sa := new(SockaddrLinklayer)
  680. sa.Protocol = pp.Protocol
  681. sa.Ifindex = int(pp.Ifindex)
  682. sa.Hatype = pp.Hatype
  683. sa.Pkttype = pp.Pkttype
  684. sa.Halen = pp.Halen
  685. for i := 0; i < len(sa.Addr); i++ {
  686. sa.Addr[i] = pp.Addr[i]
  687. }
  688. return sa, nil
  689. case AF_UNIX:
  690. pp := (*RawSockaddrUnix)(unsafe.Pointer(rsa))
  691. sa := new(SockaddrUnix)
  692. if pp.Path[0] == 0 {
  693. // "Abstract" Unix domain socket.
  694. // Rewrite leading NUL as @ for textual display.
  695. // (This is the standard convention.)
  696. // Not friendly to overwrite in place,
  697. // but the callers below don't care.
  698. pp.Path[0] = '@'
  699. }
  700. // Assume path ends at NUL.
  701. // This is not technically the Linux semantics for
  702. // abstract Unix domain sockets--they are supposed
  703. // to be uninterpreted fixed-size binary blobs--but
  704. // everyone uses this convention.
  705. n := 0
  706. for n < len(pp.Path) && pp.Path[n] != 0 {
  707. n++
  708. }
  709. bytes := (*[10000]byte)(unsafe.Pointer(&pp.Path[0]))[0:n]
  710. sa.Name = string(bytes)
  711. return sa, nil
  712. case AF_INET:
  713. pp := (*RawSockaddrInet4)(unsafe.Pointer(rsa))
  714. sa := new(SockaddrInet4)
  715. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  716. sa.Port = int(p[0])<<8 + int(p[1])
  717. for i := 0; i < len(sa.Addr); i++ {
  718. sa.Addr[i] = pp.Addr[i]
  719. }
  720. return sa, nil
  721. case AF_INET6:
  722. pp := (*RawSockaddrInet6)(unsafe.Pointer(rsa))
  723. sa := new(SockaddrInet6)
  724. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  725. sa.Port = int(p[0])<<8 + int(p[1])
  726. sa.ZoneId = pp.Scope_id
  727. for i := 0; i < len(sa.Addr); i++ {
  728. sa.Addr[i] = pp.Addr[i]
  729. }
  730. return sa, nil
  731. case AF_VSOCK:
  732. pp := (*RawSockaddrVM)(unsafe.Pointer(rsa))
  733. sa := &SockaddrVM{
  734. CID: pp.Cid,
  735. Port: pp.Port,
  736. }
  737. return sa, nil
  738. case AF_BLUETOOTH:
  739. proto, err := GetsockoptInt(fd, SOL_SOCKET, SO_PROTOCOL)
  740. if err != nil {
  741. return nil, err
  742. }
  743. // only BTPROTO_L2CAP and BTPROTO_RFCOMM can accept connections
  744. switch proto {
  745. case BTPROTO_L2CAP:
  746. pp := (*RawSockaddrL2)(unsafe.Pointer(rsa))
  747. sa := &SockaddrL2{
  748. PSM: pp.Psm,
  749. CID: pp.Cid,
  750. Addr: pp.Bdaddr,
  751. AddrType: pp.Bdaddr_type,
  752. }
  753. return sa, nil
  754. case BTPROTO_RFCOMM:
  755. pp := (*RawSockaddrRFCOMM)(unsafe.Pointer(rsa))
  756. sa := &SockaddrRFCOMM{
  757. Channel: pp.Channel,
  758. Addr: pp.Bdaddr,
  759. }
  760. return sa, nil
  761. }
  762. case AF_XDP:
  763. pp := (*RawSockaddrXDP)(unsafe.Pointer(rsa))
  764. sa := &SockaddrXDP{
  765. Flags: pp.Flags,
  766. Ifindex: pp.Ifindex,
  767. QueueID: pp.Queue_id,
  768. SharedUmemFD: pp.Shared_umem_fd,
  769. }
  770. return sa, nil
  771. case AF_PPPOX:
  772. pp := (*RawSockaddrPPPoX)(unsafe.Pointer(rsa))
  773. if binary.BigEndian.Uint32(pp[2:6]) != px_proto_oe {
  774. return nil, EINVAL
  775. }
  776. sa := &SockaddrPPPoE{
  777. SID: binary.BigEndian.Uint16(pp[6:8]),
  778. Remote: pp[8:14],
  779. }
  780. for i := 14; i < 14+IFNAMSIZ; i++ {
  781. if pp[i] == 0 {
  782. sa.Dev = string(pp[14:i])
  783. break
  784. }
  785. }
  786. return sa, nil
  787. }
  788. return nil, EAFNOSUPPORT
  789. }
  790. func Accept(fd int) (nfd int, sa Sockaddr, err error) {
  791. var rsa RawSockaddrAny
  792. var len _Socklen = SizeofSockaddrAny
  793. nfd, err = accept(fd, &rsa, &len)
  794. if err != nil {
  795. return
  796. }
  797. sa, err = anyToSockaddr(fd, &rsa)
  798. if err != nil {
  799. Close(nfd)
  800. nfd = 0
  801. }
  802. return
  803. }
  804. func Accept4(fd int, flags int) (nfd int, sa Sockaddr, err error) {
  805. var rsa RawSockaddrAny
  806. var len _Socklen = SizeofSockaddrAny
  807. nfd, err = accept4(fd, &rsa, &len, flags)
  808. if err != nil {
  809. return
  810. }
  811. if len > SizeofSockaddrAny {
  812. panic("RawSockaddrAny too small")
  813. }
  814. sa, err = anyToSockaddr(fd, &rsa)
  815. if err != nil {
  816. Close(nfd)
  817. nfd = 0
  818. }
  819. return
  820. }
  821. func Getsockname(fd int) (sa Sockaddr, err error) {
  822. var rsa RawSockaddrAny
  823. var len _Socklen = SizeofSockaddrAny
  824. if err = getsockname(fd, &rsa, &len); err != nil {
  825. return
  826. }
  827. return anyToSockaddr(fd, &rsa)
  828. }
  829. func GetsockoptIPMreqn(fd, level, opt int) (*IPMreqn, error) {
  830. var value IPMreqn
  831. vallen := _Socklen(SizeofIPMreqn)
  832. err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
  833. return &value, err
  834. }
  835. func GetsockoptUcred(fd, level, opt int) (*Ucred, error) {
  836. var value Ucred
  837. vallen := _Socklen(SizeofUcred)
  838. err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
  839. return &value, err
  840. }
  841. func GetsockoptTCPInfo(fd, level, opt int) (*TCPInfo, error) {
  842. var value TCPInfo
  843. vallen := _Socklen(SizeofTCPInfo)
  844. err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
  845. return &value, err
  846. }
  847. // GetsockoptString returns the string value of the socket option opt for the
  848. // socket associated with fd at the given socket level.
  849. func GetsockoptString(fd, level, opt int) (string, error) {
  850. buf := make([]byte, 256)
  851. vallen := _Socklen(len(buf))
  852. err := getsockopt(fd, level, opt, unsafe.Pointer(&buf[0]), &vallen)
  853. if err != nil {
  854. if err == ERANGE {
  855. buf = make([]byte, vallen)
  856. err = getsockopt(fd, level, opt, unsafe.Pointer(&buf[0]), &vallen)
  857. }
  858. if err != nil {
  859. return "", err
  860. }
  861. }
  862. return string(buf[:vallen-1]), nil
  863. }
  864. func GetsockoptTpacketStats(fd, level, opt int) (*TpacketStats, error) {
  865. var value TpacketStats
  866. vallen := _Socklen(SizeofTpacketStats)
  867. err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
  868. return &value, err
  869. }
  870. func GetsockoptTpacketStatsV3(fd, level, opt int) (*TpacketStatsV3, error) {
  871. var value TpacketStatsV3
  872. vallen := _Socklen(SizeofTpacketStatsV3)
  873. err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
  874. return &value, err
  875. }
  876. func SetsockoptIPMreqn(fd, level, opt int, mreq *IPMreqn) (err error) {
  877. return setsockopt(fd, level, opt, unsafe.Pointer(mreq), unsafe.Sizeof(*mreq))
  878. }
  879. func SetsockoptPacketMreq(fd, level, opt int, mreq *PacketMreq) error {
  880. return setsockopt(fd, level, opt, unsafe.Pointer(mreq), unsafe.Sizeof(*mreq))
  881. }
  882. // SetsockoptSockFprog attaches a classic BPF or an extended BPF program to a
  883. // socket to filter incoming packets. See 'man 7 socket' for usage information.
  884. func SetsockoptSockFprog(fd, level, opt int, fprog *SockFprog) error {
  885. return setsockopt(fd, level, opt, unsafe.Pointer(fprog), unsafe.Sizeof(*fprog))
  886. }
  887. func SetsockoptCanRawFilter(fd, level, opt int, filter []CanFilter) error {
  888. var p unsafe.Pointer
  889. if len(filter) > 0 {
  890. p = unsafe.Pointer(&filter[0])
  891. }
  892. return setsockopt(fd, level, opt, p, uintptr(len(filter)*SizeofCanFilter))
  893. }
  894. func SetsockoptTpacketReq(fd, level, opt int, tp *TpacketReq) error {
  895. return setsockopt(fd, level, opt, unsafe.Pointer(tp), unsafe.Sizeof(*tp))
  896. }
  897. func SetsockoptTpacketReq3(fd, level, opt int, tp *TpacketReq3) error {
  898. return setsockopt(fd, level, opt, unsafe.Pointer(tp), unsafe.Sizeof(*tp))
  899. }
  900. // Keyctl Commands (http://man7.org/linux/man-pages/man2/keyctl.2.html)
  901. // KeyctlInt calls keyctl commands in which each argument is an int.
  902. // These commands are KEYCTL_REVOKE, KEYCTL_CHOWN, KEYCTL_CLEAR, KEYCTL_LINK,
  903. // KEYCTL_UNLINK, KEYCTL_NEGATE, KEYCTL_SET_REQKEY_KEYRING, KEYCTL_SET_TIMEOUT,
  904. // KEYCTL_ASSUME_AUTHORITY, KEYCTL_SESSION_TO_PARENT, KEYCTL_REJECT,
  905. // KEYCTL_INVALIDATE, and KEYCTL_GET_PERSISTENT.
  906. //sys KeyctlInt(cmd int, arg2 int, arg3 int, arg4 int, arg5 int) (ret int, err error) = SYS_KEYCTL
  907. // KeyctlBuffer calls keyctl commands in which the third and fourth
  908. // arguments are a buffer and its length, respectively.
  909. // These commands are KEYCTL_UPDATE, KEYCTL_READ, and KEYCTL_INSTANTIATE.
  910. //sys KeyctlBuffer(cmd int, arg2 int, buf []byte, arg5 int) (ret int, err error) = SYS_KEYCTL
  911. // KeyctlString calls keyctl commands which return a string.
  912. // These commands are KEYCTL_DESCRIBE and KEYCTL_GET_SECURITY.
  913. func KeyctlString(cmd int, id int) (string, error) {
  914. // We must loop as the string data may change in between the syscalls.
  915. // We could allocate a large buffer here to reduce the chance that the
  916. // syscall needs to be called twice; however, this is unnecessary as
  917. // the performance loss is negligible.
  918. var buffer []byte
  919. for {
  920. // Try to fill the buffer with data
  921. length, err := KeyctlBuffer(cmd, id, buffer, 0)
  922. if err != nil {
  923. return "", err
  924. }
  925. // Check if the data was written
  926. if length <= len(buffer) {
  927. // Exclude the null terminator
  928. return string(buffer[:length-1]), nil
  929. }
  930. // Make a bigger buffer if needed
  931. buffer = make([]byte, length)
  932. }
  933. }
  934. // Keyctl commands with special signatures.
  935. // KeyctlGetKeyringID implements the KEYCTL_GET_KEYRING_ID command.
  936. // See the full documentation at:
  937. // http://man7.org/linux/man-pages/man3/keyctl_get_keyring_ID.3.html
  938. func KeyctlGetKeyringID(id int, create bool) (ringid int, err error) {
  939. createInt := 0
  940. if create {
  941. createInt = 1
  942. }
  943. return KeyctlInt(KEYCTL_GET_KEYRING_ID, id, createInt, 0, 0)
  944. }
  945. // KeyctlSetperm implements the KEYCTL_SETPERM command. The perm value is the
  946. // key handle permission mask as described in the "keyctl setperm" section of
  947. // http://man7.org/linux/man-pages/man1/keyctl.1.html.
  948. // See the full documentation at:
  949. // http://man7.org/linux/man-pages/man3/keyctl_setperm.3.html
  950. func KeyctlSetperm(id int, perm uint32) error {
  951. _, err := KeyctlInt(KEYCTL_SETPERM, id, int(perm), 0, 0)
  952. return err
  953. }
  954. //sys keyctlJoin(cmd int, arg2 string) (ret int, err error) = SYS_KEYCTL
  955. // KeyctlJoinSessionKeyring implements the KEYCTL_JOIN_SESSION_KEYRING command.
  956. // See the full documentation at:
  957. // http://man7.org/linux/man-pages/man3/keyctl_join_session_keyring.3.html
  958. func KeyctlJoinSessionKeyring(name string) (ringid int, err error) {
  959. return keyctlJoin(KEYCTL_JOIN_SESSION_KEYRING, name)
  960. }
  961. //sys keyctlSearch(cmd int, arg2 int, arg3 string, arg4 string, arg5 int) (ret int, err error) = SYS_KEYCTL
  962. // KeyctlSearch implements the KEYCTL_SEARCH command.
  963. // See the full documentation at:
  964. // http://man7.org/linux/man-pages/man3/keyctl_search.3.html
  965. func KeyctlSearch(ringid int, keyType, description string, destRingid int) (id int, err error) {
  966. return keyctlSearch(KEYCTL_SEARCH, ringid, keyType, description, destRingid)
  967. }
  968. //sys keyctlIOV(cmd int, arg2 int, payload []Iovec, arg5 int) (err error) = SYS_KEYCTL
  969. // KeyctlInstantiateIOV implements the KEYCTL_INSTANTIATE_IOV command. This
  970. // command is similar to KEYCTL_INSTANTIATE, except that the payload is a slice
  971. // of Iovec (each of which represents a buffer) instead of a single buffer.
  972. // See the full documentation at:
  973. // http://man7.org/linux/man-pages/man3/keyctl_instantiate_iov.3.html
  974. func KeyctlInstantiateIOV(id int, payload []Iovec, ringid int) error {
  975. return keyctlIOV(KEYCTL_INSTANTIATE_IOV, id, payload, ringid)
  976. }
  977. //sys keyctlDH(cmd int, arg2 *KeyctlDHParams, buf []byte) (ret int, err error) = SYS_KEYCTL
  978. // KeyctlDHCompute implements the KEYCTL_DH_COMPUTE command. This command
  979. // computes a Diffie-Hellman shared secret based on the provide params. The
  980. // secret is written to the provided buffer and the returned size is the number
  981. // of bytes written (returning an error if there is insufficient space in the
  982. // buffer). If a nil buffer is passed in, this function returns the minimum
  983. // buffer length needed to store the appropriate data. Note that this differs
  984. // from KEYCTL_READ's behavior which always returns the requested payload size.
  985. // See the full documentation at:
  986. // http://man7.org/linux/man-pages/man3/keyctl_dh_compute.3.html
  987. func KeyctlDHCompute(params *KeyctlDHParams, buffer []byte) (size int, err error) {
  988. return keyctlDH(KEYCTL_DH_COMPUTE, params, buffer)
  989. }
  990. func Recvmsg(fd int, p, oob []byte, flags int) (n, oobn int, recvflags int, from Sockaddr, err error) {
  991. var msg Msghdr
  992. var rsa RawSockaddrAny
  993. msg.Name = (*byte)(unsafe.Pointer(&rsa))
  994. msg.Namelen = uint32(SizeofSockaddrAny)
  995. var iov Iovec
  996. if len(p) > 0 {
  997. iov.Base = &p[0]
  998. iov.SetLen(len(p))
  999. }
  1000. var dummy byte
  1001. if len(oob) > 0 {
  1002. if len(p) == 0 {
  1003. var sockType int
  1004. sockType, err = GetsockoptInt(fd, SOL_SOCKET, SO_TYPE)
  1005. if err != nil {
  1006. return
  1007. }
  1008. // receive at least one normal byte
  1009. if sockType != SOCK_DGRAM {
  1010. iov.Base = &dummy
  1011. iov.SetLen(1)
  1012. }
  1013. }
  1014. msg.Control = &oob[0]
  1015. msg.SetControllen(len(oob))
  1016. }
  1017. msg.Iov = &iov
  1018. msg.Iovlen = 1
  1019. if n, err = recvmsg(fd, &msg, flags); err != nil {
  1020. return
  1021. }
  1022. oobn = int(msg.Controllen)
  1023. recvflags = int(msg.Flags)
  1024. // source address is only specified if the socket is unconnected
  1025. if rsa.Addr.Family != AF_UNSPEC {
  1026. from, err = anyToSockaddr(fd, &rsa)
  1027. }
  1028. return
  1029. }
  1030. func Sendmsg(fd int, p, oob []byte, to Sockaddr, flags int) (err error) {
  1031. _, err = SendmsgN(fd, p, oob, to, flags)
  1032. return
  1033. }
  1034. func SendmsgN(fd int, p, oob []byte, to Sockaddr, flags int) (n int, err error) {
  1035. var ptr unsafe.Pointer
  1036. var salen _Socklen
  1037. if to != nil {
  1038. var err error
  1039. ptr, salen, err = to.sockaddr()
  1040. if err != nil {
  1041. return 0, err
  1042. }
  1043. }
  1044. var msg Msghdr
  1045. msg.Name = (*byte)(ptr)
  1046. msg.Namelen = uint32(salen)
  1047. var iov Iovec
  1048. if len(p) > 0 {
  1049. iov.Base = &p[0]
  1050. iov.SetLen(len(p))
  1051. }
  1052. var dummy byte
  1053. if len(oob) > 0 {
  1054. if len(p) == 0 {
  1055. var sockType int
  1056. sockType, err = GetsockoptInt(fd, SOL_SOCKET, SO_TYPE)
  1057. if err != nil {
  1058. return 0, err
  1059. }
  1060. // send at least one normal byte
  1061. if sockType != SOCK_DGRAM {
  1062. iov.Base = &dummy
  1063. iov.SetLen(1)
  1064. }
  1065. }
  1066. msg.Control = &oob[0]
  1067. msg.SetControllen(len(oob))
  1068. }
  1069. msg.Iov = &iov
  1070. msg.Iovlen = 1
  1071. if n, err = sendmsg(fd, &msg, flags); err != nil {
  1072. return 0, err
  1073. }
  1074. if len(oob) > 0 && len(p) == 0 {
  1075. n = 0
  1076. }
  1077. return n, nil
  1078. }
  1079. // BindToDevice binds the socket associated with fd to device.
  1080. func BindToDevice(fd int, device string) (err error) {
  1081. return SetsockoptString(fd, SOL_SOCKET, SO_BINDTODEVICE, device)
  1082. }
  1083. //sys ptrace(request int, pid int, addr uintptr, data uintptr) (err error)
  1084. func ptracePeek(req int, pid int, addr uintptr, out []byte) (count int, err error) {
  1085. // The peek requests are machine-size oriented, so we wrap it
  1086. // to retrieve arbitrary-length data.
  1087. // The ptrace syscall differs from glibc's ptrace.
  1088. // Peeks returns the word in *data, not as the return value.
  1089. var buf [SizeofPtr]byte
  1090. // Leading edge. PEEKTEXT/PEEKDATA don't require aligned
  1091. // access (PEEKUSER warns that it might), but if we don't
  1092. // align our reads, we might straddle an unmapped page
  1093. // boundary and not get the bytes leading up to the page
  1094. // boundary.
  1095. n := 0
  1096. if addr%SizeofPtr != 0 {
  1097. err = ptrace(req, pid, addr-addr%SizeofPtr, uintptr(unsafe.Pointer(&buf[0])))
  1098. if err != nil {
  1099. return 0, err
  1100. }
  1101. n += copy(out, buf[addr%SizeofPtr:])
  1102. out = out[n:]
  1103. }
  1104. // Remainder.
  1105. for len(out) > 0 {
  1106. // We use an internal buffer to guarantee alignment.
  1107. // It's not documented if this is necessary, but we're paranoid.
  1108. err = ptrace(req, pid, addr+uintptr(n), uintptr(unsafe.Pointer(&buf[0])))
  1109. if err != nil {
  1110. return n, err
  1111. }
  1112. copied := copy(out, buf[0:])
  1113. n += copied
  1114. out = out[copied:]
  1115. }
  1116. return n, nil
  1117. }
  1118. func PtracePeekText(pid int, addr uintptr, out []byte) (count int, err error) {
  1119. return ptracePeek(PTRACE_PEEKTEXT, pid, addr, out)
  1120. }
  1121. func PtracePeekData(pid int, addr uintptr, out []byte) (count int, err error) {
  1122. return ptracePeek(PTRACE_PEEKDATA, pid, addr, out)
  1123. }
  1124. func PtracePeekUser(pid int, addr uintptr, out []byte) (count int, err error) {
  1125. return ptracePeek(PTRACE_PEEKUSR, pid, addr, out)
  1126. }
  1127. func ptracePoke(pokeReq int, peekReq int, pid int, addr uintptr, data []byte) (count int, err error) {
  1128. // As for ptracePeek, we need to align our accesses to deal
  1129. // with the possibility of straddling an invalid page.
  1130. // Leading edge.
  1131. n := 0
  1132. if addr%SizeofPtr != 0 {
  1133. var buf [SizeofPtr]byte
  1134. err = ptrace(peekReq, pid, addr-addr%SizeofPtr, uintptr(unsafe.Pointer(&buf[0])))
  1135. if err != nil {
  1136. return 0, err
  1137. }
  1138. n += copy(buf[addr%SizeofPtr:], data)
  1139. word := *((*uintptr)(unsafe.Pointer(&buf[0])))
  1140. err = ptrace(pokeReq, pid, addr-addr%SizeofPtr, word)
  1141. if err != nil {
  1142. return 0, err
  1143. }
  1144. data = data[n:]
  1145. }
  1146. // Interior.
  1147. for len(data) > SizeofPtr {
  1148. word := *((*uintptr)(unsafe.Pointer(&data[0])))
  1149. err = ptrace(pokeReq, pid, addr+uintptr(n), word)
  1150. if err != nil {
  1151. return n, err
  1152. }
  1153. n += SizeofPtr
  1154. data = data[SizeofPtr:]
  1155. }
  1156. // Trailing edge.
  1157. if len(data) > 0 {
  1158. var buf [SizeofPtr]byte
  1159. err = ptrace(peekReq, pid, addr+uintptr(n), uintptr(unsafe.Pointer(&buf[0])))
  1160. if err != nil {
  1161. return n, err
  1162. }
  1163. copy(buf[0:], data)
  1164. word := *((*uintptr)(unsafe.Pointer(&buf[0])))
  1165. err = ptrace(pokeReq, pid, addr+uintptr(n), word)
  1166. if err != nil {
  1167. return n, err
  1168. }
  1169. n += len(data)
  1170. }
  1171. return n, nil
  1172. }
  1173. func PtracePokeText(pid int, addr uintptr, data []byte) (count int, err error) {
  1174. return ptracePoke(PTRACE_POKETEXT, PTRACE_PEEKTEXT, pid, addr, data)
  1175. }
  1176. func PtracePokeData(pid int, addr uintptr, data []byte) (count int, err error) {
  1177. return ptracePoke(PTRACE_POKEDATA, PTRACE_PEEKDATA, pid, addr, data)
  1178. }
  1179. func PtracePokeUser(pid int, addr uintptr, data []byte) (count int, err error) {
  1180. return ptracePoke(PTRACE_POKEUSR, PTRACE_PEEKUSR, pid, addr, data)
  1181. }
  1182. func PtraceGetRegs(pid int, regsout *PtraceRegs) (err error) {
  1183. return ptrace(PTRACE_GETREGS, pid, 0, uintptr(unsafe.Pointer(regsout)))
  1184. }
  1185. func PtraceSetRegs(pid int, regs *PtraceRegs) (err error) {
  1186. return ptrace(PTRACE_SETREGS, pid, 0, uintptr(unsafe.Pointer(regs)))
  1187. }
  1188. func PtraceSetOptions(pid int, options int) (err error) {
  1189. return ptrace(PTRACE_SETOPTIONS, pid, 0, uintptr(options))
  1190. }
  1191. func PtraceGetEventMsg(pid int) (msg uint, err error) {
  1192. var data _C_long
  1193. err = ptrace(PTRACE_GETEVENTMSG, pid, 0, uintptr(unsafe.Pointer(&data)))
  1194. msg = uint(data)
  1195. return
  1196. }
  1197. func PtraceCont(pid int, signal int) (err error) {
  1198. return ptrace(PTRACE_CONT, pid, 0, uintptr(signal))
  1199. }
  1200. func PtraceSyscall(pid int, signal int) (err error) {
  1201. return ptrace(PTRACE_SYSCALL, pid, 0, uintptr(signal))
  1202. }
  1203. func PtraceSingleStep(pid int) (err error) { return ptrace(PTRACE_SINGLESTEP, pid, 0, 0) }
  1204. func PtraceAttach(pid int) (err error) { return ptrace(PTRACE_ATTACH, pid, 0, 0) }
  1205. func PtraceDetach(pid int) (err error) { return ptrace(PTRACE_DETACH, pid, 0, 0) }
  1206. //sys reboot(magic1 uint, magic2 uint, cmd int, arg string) (err error)
  1207. func Reboot(cmd int) (err error) {
  1208. return reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2, cmd, "")
  1209. }
  1210. func direntIno(buf []byte) (uint64, bool) {
  1211. return readInt(buf, unsafe.Offsetof(Dirent{}.Ino), unsafe.Sizeof(Dirent{}.Ino))
  1212. }
  1213. func direntReclen(buf []byte) (uint64, bool) {
  1214. return readInt(buf, unsafe.Offsetof(Dirent{}.Reclen), unsafe.Sizeof(Dirent{}.Reclen))
  1215. }
  1216. func direntNamlen(buf []byte) (uint64, bool) {
  1217. reclen, ok := direntReclen(buf)
  1218. if !ok {
  1219. return 0, false
  1220. }
  1221. return reclen - uint64(unsafe.Offsetof(Dirent{}.Name)), true
  1222. }
  1223. //sys mount(source string, target string, fstype string, flags uintptr, data *byte) (err error)
  1224. func Mount(source string, target string, fstype string, flags uintptr, data string) (err error) {
  1225. // Certain file systems get rather angry and EINVAL if you give
  1226. // them an empty string of data, rather than NULL.
  1227. if data == "" {
  1228. return mount(source, target, fstype, flags, nil)
  1229. }
  1230. datap, err := BytePtrFromString(data)
  1231. if err != nil {
  1232. return err
  1233. }
  1234. return mount(source, target, fstype, flags, datap)
  1235. }
  1236. func Sendfile(outfd int, infd int, offset *int64, count int) (written int, err error) {
  1237. if raceenabled {
  1238. raceReleaseMerge(unsafe.Pointer(&ioSync))
  1239. }
  1240. return sendfile(outfd, infd, offset, count)
  1241. }
  1242. // Sendto
  1243. // Recvfrom
  1244. // Socketpair
  1245. /*
  1246. * Direct access
  1247. */
  1248. //sys Acct(path string) (err error)
  1249. //sys AddKey(keyType string, description string, payload []byte, ringid int) (id int, err error)
  1250. //sys Adjtimex(buf *Timex) (state int, err error)
  1251. //sys Capget(hdr *CapUserHeader, data *CapUserData) (err error)
  1252. //sys Capset(hdr *CapUserHeader, data *CapUserData) (err error)
  1253. //sys Chdir(path string) (err error)
  1254. //sys Chroot(path string) (err error)
  1255. //sys ClockGetres(clockid int32, res *Timespec) (err error)
  1256. //sys ClockGettime(clockid int32, time *Timespec) (err error)
  1257. //sys ClockNanosleep(clockid int32, flags int, request *Timespec, remain *Timespec) (err error)
  1258. //sys Close(fd int) (err error)
  1259. //sys CopyFileRange(rfd int, roff *int64, wfd int, woff *int64, len int, flags int) (n int, err error)
  1260. //sys DeleteModule(name string, flags int) (err error)
  1261. //sys Dup(oldfd int) (fd int, err error)
  1262. //sys Dup3(oldfd int, newfd int, flags int) (err error)
  1263. //sysnb EpollCreate1(flag int) (fd int, err error)
  1264. //sysnb EpollCtl(epfd int, op int, fd int, event *EpollEvent) (err error)
  1265. //sys Eventfd(initval uint, flags int) (fd int, err error) = SYS_EVENTFD2
  1266. //sys Exit(code int) = SYS_EXIT_GROUP
  1267. //sys Fallocate(fd int, mode uint32, off int64, len int64) (err error)
  1268. //sys Fchdir(fd int) (err error)
  1269. //sys Fchmod(fd int, mode uint32) (err error)
  1270. //sys Fchownat(dirfd int, path string, uid int, gid int, flags int) (err error)
  1271. //sys fcntl(fd int, cmd int, arg int) (val int, err error)
  1272. //sys Fdatasync(fd int) (err error)
  1273. //sys Fgetxattr(fd int, attr string, dest []byte) (sz int, err error)
  1274. //sys FinitModule(fd int, params string, flags int) (err error)
  1275. //sys Flistxattr(fd int, dest []byte) (sz int, err error)
  1276. //sys Flock(fd int, how int) (err error)
  1277. //sys Fremovexattr(fd int, attr string) (err error)
  1278. //sys Fsetxattr(fd int, attr string, dest []byte, flags int) (err error)
  1279. //sys Fsync(fd int) (err error)
  1280. //sys Getdents(fd int, buf []byte) (n int, err error) = SYS_GETDENTS64
  1281. //sysnb Getpgid(pid int) (pgid int, err error)
  1282. func Getpgrp() (pid int) {
  1283. pid, _ = Getpgid(0)
  1284. return
  1285. }
  1286. //sysnb Getpid() (pid int)
  1287. //sysnb Getppid() (ppid int)
  1288. //sys Getpriority(which int, who int) (prio int, err error)
  1289. //sys Getrandom(buf []byte, flags int) (n int, err error)
  1290. //sysnb Getrusage(who int, rusage *Rusage) (err error)
  1291. //sysnb Getsid(pid int) (sid int, err error)
  1292. //sysnb Gettid() (tid int)
  1293. //sys Getxattr(path string, attr string, dest []byte) (sz int, err error)
  1294. //sys InitModule(moduleImage []byte, params string) (err error)
  1295. //sys InotifyAddWatch(fd int, pathname string, mask uint32) (watchdesc int, err error)
  1296. //sysnb InotifyInit1(flags int) (fd int, err error)
  1297. //sysnb InotifyRmWatch(fd int, watchdesc uint32) (success int, err error)
  1298. //sysnb Kill(pid int, sig syscall.Signal) (err error)
  1299. //sys Klogctl(typ int, buf []byte) (n int, err error) = SYS_SYSLOG
  1300. //sys Lgetxattr(path string, attr string, dest []byte) (sz int, err error)
  1301. //sys Listxattr(path string, dest []byte) (sz int, err error)
  1302. //sys Llistxattr(path string, dest []byte) (sz int, err error)
  1303. //sys Lremovexattr(path string, attr string) (err error)
  1304. //sys Lsetxattr(path string, attr string, data []byte, flags int) (err error)
  1305. //sys MemfdCreate(name string, flags int) (fd int, err error)
  1306. //sys Mkdirat(dirfd int, path string, mode uint32) (err error)
  1307. //sys Mknodat(dirfd int, path string, mode uint32, dev int) (err error)
  1308. //sys Nanosleep(time *Timespec, leftover *Timespec) (err error)
  1309. //sys PerfEventOpen(attr *PerfEventAttr, pid int, cpu int, groupFd int, flags int) (fd int, err error)
  1310. //sys PivotRoot(newroot string, putold string) (err error) = SYS_PIVOT_ROOT
  1311. //sysnb prlimit(pid int, resource int, newlimit *Rlimit, old *Rlimit) (err error) = SYS_PRLIMIT64
  1312. //sys Prctl(option int, arg2 uintptr, arg3 uintptr, arg4 uintptr, arg5 uintptr) (err error)
  1313. //sys Pselect(nfd int, r *FdSet, w *FdSet, e *FdSet, timeout *Timespec, sigmask *Sigset_t) (n int, err error) = SYS_PSELECT6
  1314. //sys read(fd int, p []byte) (n int, err error)
  1315. //sys Removexattr(path string, attr string) (err error)
  1316. //sys Renameat2(olddirfd int, oldpath string, newdirfd int, newpath string, flags uint) (err error)
  1317. //sys RequestKey(keyType string, description string, callback string, destRingid int) (id int, err error)
  1318. //sys Setdomainname(p []byte) (err error)
  1319. //sys Sethostname(p []byte) (err error)
  1320. //sysnb Setpgid(pid int, pgid int) (err error)
  1321. //sysnb Setsid() (pid int, err error)
  1322. //sysnb Settimeofday(tv *Timeval) (err error)
  1323. //sys Setns(fd int, nstype int) (err error)
  1324. // issue 1435.
  1325. // On linux Setuid and Setgid only affects the current thread, not the process.
  1326. // This does not match what most callers expect so we must return an error
  1327. // here rather than letting the caller think that the call succeeded.
  1328. func Setuid(uid int) (err error) {
  1329. return EOPNOTSUPP
  1330. }
  1331. func Setgid(uid int) (err error) {
  1332. return EOPNOTSUPP
  1333. }
  1334. func Signalfd(fd int, sigmask *Sigset_t, flags int) (newfd int, err error) {
  1335. return signalfd(fd, sigmask, _C__NSIG/8, flags)
  1336. }
  1337. //sys Setpriority(which int, who int, prio int) (err error)
  1338. //sys Setxattr(path string, attr string, data []byte, flags int) (err error)
  1339. //sys signalfd(fd int, sigmask *Sigset_t, maskSize uintptr, flags int) (newfd int, err error) = SYS_SIGNALFD4
  1340. //sys Statx(dirfd int, path string, flags int, mask int, stat *Statx_t) (err error)
  1341. //sys Sync()
  1342. //sys Syncfs(fd int) (err error)
  1343. //sysnb Sysinfo(info *Sysinfo_t) (err error)
  1344. //sys Tee(rfd int, wfd int, len int, flags int) (n int64, err error)
  1345. //sysnb Tgkill(tgid int, tid int, sig syscall.Signal) (err error)
  1346. //sysnb Times(tms *Tms) (ticks uintptr, err error)
  1347. //sysnb Umask(mask int) (oldmask int)
  1348. //sysnb Uname(buf *Utsname) (err error)
  1349. //sys Unmount(target string, flags int) (err error) = SYS_UMOUNT2
  1350. //sys Unshare(flags int) (err error)
  1351. //sys write(fd int, p []byte) (n int, err error)
  1352. //sys exitThread(code int) (err error) = SYS_EXIT
  1353. //sys readlen(fd int, p *byte, np int) (n int, err error) = SYS_READ
  1354. //sys writelen(fd int, p *byte, np int) (n int, err error) = SYS_WRITE
  1355. // mmap varies by architecture; see syscall_linux_*.go.
  1356. //sys munmap(addr uintptr, length uintptr) (err error)
  1357. var mapper = &mmapper{
  1358. active: make(map[*byte][]byte),
  1359. mmap: mmap,
  1360. munmap: munmap,
  1361. }
  1362. func Mmap(fd int, offset int64, length int, prot int, flags int) (data []byte, err error) {
  1363. return mapper.Mmap(fd, offset, length, prot, flags)
  1364. }
  1365. func Munmap(b []byte) (err error) {
  1366. return mapper.Munmap(b)
  1367. }
  1368. //sys Madvise(b []byte, advice int) (err error)
  1369. //sys Mprotect(b []byte, prot int) (err error)
  1370. //sys Mlock(b []byte) (err error)
  1371. //sys Mlockall(flags int) (err error)
  1372. //sys Msync(b []byte, flags int) (err error)
  1373. //sys Munlock(b []byte) (err error)
  1374. //sys Munlockall() (err error)
  1375. // Vmsplice splices user pages from a slice of Iovecs into a pipe specified by fd,
  1376. // using the specified flags.
  1377. func Vmsplice(fd int, iovs []Iovec, flags int) (int, error) {
  1378. var p unsafe.Pointer
  1379. if len(iovs) > 0 {
  1380. p = unsafe.Pointer(&iovs[0])
  1381. }
  1382. n, _, errno := Syscall6(SYS_VMSPLICE, uintptr(fd), uintptr(p), uintptr(len(iovs)), uintptr(flags), 0, 0)
  1383. if errno != 0 {
  1384. return 0, syscall.Errno(errno)
  1385. }
  1386. return int(n), nil
  1387. }
  1388. //sys faccessat(dirfd int, path string, mode uint32) (err error)
  1389. func Faccessat(dirfd int, path string, mode uint32, flags int) (err error) {
  1390. if flags & ^(AT_SYMLINK_NOFOLLOW|AT_EACCESS) != 0 {
  1391. return EINVAL
  1392. }
  1393. // The Linux kernel faccessat system call does not take any flags.
  1394. // The glibc faccessat implements the flags itself; see
  1395. // https://sourceware.org/git/?p=glibc.git;a=blob;f=sysdeps/unix/sysv/linux/faccessat.c;hb=HEAD
  1396. // Because people naturally expect syscall.Faccessat to act
  1397. // like C faccessat, we do the same.
  1398. if flags == 0 {
  1399. return faccessat(dirfd, path, mode)
  1400. }
  1401. var st Stat_t
  1402. if err := Fstatat(dirfd, path, &st, flags&AT_SYMLINK_NOFOLLOW); err != nil {
  1403. return err
  1404. }
  1405. mode &= 7
  1406. if mode == 0 {
  1407. return nil
  1408. }
  1409. var uid int
  1410. if flags&AT_EACCESS != 0 {
  1411. uid = Geteuid()
  1412. } else {
  1413. uid = Getuid()
  1414. }
  1415. if uid == 0 {
  1416. if mode&1 == 0 {
  1417. // Root can read and write any file.
  1418. return nil
  1419. }
  1420. if st.Mode&0111 != 0 {
  1421. // Root can execute any file that anybody can execute.
  1422. return nil
  1423. }
  1424. return EACCES
  1425. }
  1426. var fmode uint32
  1427. if uint32(uid) == st.Uid {
  1428. fmode = (st.Mode >> 6) & 7
  1429. } else {
  1430. var gid int
  1431. if flags&AT_EACCESS != 0 {
  1432. gid = Getegid()
  1433. } else {
  1434. gid = Getgid()
  1435. }
  1436. if uint32(gid) == st.Gid {
  1437. fmode = (st.Mode >> 3) & 7
  1438. } else {
  1439. fmode = st.Mode & 7
  1440. }
  1441. }
  1442. if fmode&mode == mode {
  1443. return nil
  1444. }
  1445. return EACCES
  1446. }
  1447. //sys nameToHandleAt(dirFD int, pathname string, fh *fileHandle, mountID *_C_int, flags int) (err error) = SYS_NAME_TO_HANDLE_AT
  1448. //sys openByHandleAt(mountFD int, fh *fileHandle, flags int) (fd int, err error) = SYS_OPEN_BY_HANDLE_AT
  1449. // fileHandle is the argument to nameToHandleAt and openByHandleAt. We
  1450. // originally tried to generate it via unix/linux/types.go with "type
  1451. // fileHandle C.struct_file_handle" but that generated empty structs
  1452. // for mips64 and mips64le. Instead, hard code it for now (it's the
  1453. // same everywhere else) until the mips64 generator issue is fixed.
  1454. type fileHandle struct {
  1455. Bytes uint32
  1456. Type int32
  1457. }
  1458. // FileHandle represents the C struct file_handle used by
  1459. // name_to_handle_at (see NameToHandleAt) and open_by_handle_at (see
  1460. // OpenByHandleAt).
  1461. type FileHandle struct {
  1462. *fileHandle
  1463. }
  1464. // NewFileHandle constructs a FileHandle.
  1465. func NewFileHandle(handleType int32, handle []byte) FileHandle {
  1466. const hdrSize = unsafe.Sizeof(fileHandle{})
  1467. buf := make([]byte, hdrSize+uintptr(len(handle)))
  1468. copy(buf[hdrSize:], handle)
  1469. fh := (*fileHandle)(unsafe.Pointer(&buf[0]))
  1470. fh.Type = handleType
  1471. fh.Bytes = uint32(len(handle))
  1472. return FileHandle{fh}
  1473. }
  1474. func (fh *FileHandle) Size() int { return int(fh.fileHandle.Bytes) }
  1475. func (fh *FileHandle) Type() int32 { return fh.fileHandle.Type }
  1476. func (fh *FileHandle) Bytes() []byte {
  1477. n := fh.Size()
  1478. if n == 0 {
  1479. return nil
  1480. }
  1481. return (*[1 << 30]byte)(unsafe.Pointer(uintptr(unsafe.Pointer(&fh.fileHandle.Type)) + 4))[:n:n]
  1482. }
  1483. // NameToHandleAt wraps the name_to_handle_at system call; it obtains
  1484. // a handle for a path name.
  1485. func NameToHandleAt(dirfd int, path string, flags int) (handle FileHandle, mountID int, err error) {
  1486. var mid _C_int
  1487. // Try first with a small buffer, assuming the handle will
  1488. // only be 32 bytes.
  1489. size := uint32(32 + unsafe.Sizeof(fileHandle{}))
  1490. didResize := false
  1491. for {
  1492. buf := make([]byte, size)
  1493. fh := (*fileHandle)(unsafe.Pointer(&buf[0]))
  1494. fh.Bytes = size - uint32(unsafe.Sizeof(fileHandle{}))
  1495. err = nameToHandleAt(dirfd, path, fh, &mid, flags)
  1496. if err == EOVERFLOW {
  1497. if didResize {
  1498. // We shouldn't need to resize more than once
  1499. return
  1500. }
  1501. didResize = true
  1502. size = fh.Bytes + uint32(unsafe.Sizeof(fileHandle{}))
  1503. continue
  1504. }
  1505. if err != nil {
  1506. return
  1507. }
  1508. return FileHandle{fh}, int(mid), nil
  1509. }
  1510. }
  1511. // OpenByHandleAt wraps the open_by_handle_at system call; it opens a
  1512. // file via a handle as previously returned by NameToHandleAt.
  1513. func OpenByHandleAt(mountFD int, handle FileHandle, flags int) (fd int, err error) {
  1514. return openByHandleAt(mountFD, handle.fileHandle, flags)
  1515. }
  1516. /*
  1517. * Unimplemented
  1518. */
  1519. // AfsSyscall
  1520. // Alarm
  1521. // ArchPrctl
  1522. // Brk
  1523. // ClockNanosleep
  1524. // ClockSettime
  1525. // Clone
  1526. // EpollCtlOld
  1527. // EpollPwait
  1528. // EpollWaitOld
  1529. // Execve
  1530. // Fork
  1531. // Futex
  1532. // GetKernelSyms
  1533. // GetMempolicy
  1534. // GetRobustList
  1535. // GetThreadArea
  1536. // Getitimer
  1537. // Getpmsg
  1538. // IoCancel
  1539. // IoDestroy
  1540. // IoGetevents
  1541. // IoSetup
  1542. // IoSubmit
  1543. // IoprioGet
  1544. // IoprioSet
  1545. // KexecLoad
  1546. // LookupDcookie
  1547. // Mbind
  1548. // MigratePages
  1549. // Mincore
  1550. // ModifyLdt
  1551. // Mount
  1552. // MovePages
  1553. // MqGetsetattr
  1554. // MqNotify
  1555. // MqOpen
  1556. // MqTimedreceive
  1557. // MqTimedsend
  1558. // MqUnlink
  1559. // Mremap
  1560. // Msgctl
  1561. // Msgget
  1562. // Msgrcv
  1563. // Msgsnd
  1564. // Nfsservctl
  1565. // Personality
  1566. // Pselect6
  1567. // Ptrace
  1568. // Putpmsg
  1569. // Quotactl
  1570. // Readahead
  1571. // Readv
  1572. // RemapFilePages
  1573. // RestartSyscall
  1574. // RtSigaction
  1575. // RtSigpending
  1576. // RtSigprocmask
  1577. // RtSigqueueinfo
  1578. // RtSigreturn
  1579. // RtSigsuspend
  1580. // RtSigtimedwait
  1581. // SchedGetPriorityMax
  1582. // SchedGetPriorityMin
  1583. // SchedGetparam
  1584. // SchedGetscheduler
  1585. // SchedRrGetInterval
  1586. // SchedSetparam
  1587. // SchedYield
  1588. // Security
  1589. // Semctl
  1590. // Semget
  1591. // Semop
  1592. // Semtimedop
  1593. // SetMempolicy
  1594. // SetRobustList
  1595. // SetThreadArea
  1596. // SetTidAddress
  1597. // Shmat
  1598. // Shmctl
  1599. // Shmdt
  1600. // Shmget
  1601. // Sigaltstack
  1602. // Swapoff
  1603. // Swapon
  1604. // Sysfs
  1605. // TimerCreate
  1606. // TimerDelete
  1607. // TimerGetoverrun
  1608. // TimerGettime
  1609. // TimerSettime
  1610. // Timerfd
  1611. // Tkill (obsolete)
  1612. // Tuxcall
  1613. // Umount2
  1614. // Uselib
  1615. // Utimensat
  1616. // Vfork
  1617. // Vhangup
  1618. // Vserver
  1619. // Waitid
  1620. // _Sysctl