You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

syscall_linux.go 53KB

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