github.com/filosottile/go@v0.0.0-20170906193555-dbed9972d994/src/syscall/syscall_linux.go (about)

     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  
     5  // Linux system calls.
     6  // This file is compiled as ordinary Go code,
     7  // but it is also input to mksyscall,
     8  // which parses the //sys lines and generates system call stubs.
     9  // Note that sometimes we use a lowercase //sys name and
    10  // wrap it in our own nicer implementation.
    11  
    12  package syscall
    13  
    14  import "unsafe"
    15  
    16  /*
    17   * Wrapped
    18   */
    19  
    20  func Access(path string, mode uint32) (err error) {
    21  	return Faccessat(_AT_FDCWD, path, mode, 0)
    22  }
    23  
    24  func Chmod(path string, mode uint32) (err error) {
    25  	return Fchmodat(_AT_FDCWD, path, mode, 0)
    26  }
    27  
    28  func Chown(path string, uid int, gid int) (err error) {
    29  	return Fchownat(_AT_FDCWD, path, uid, gid, 0)
    30  }
    31  
    32  func Creat(path string, mode uint32) (fd int, err error) {
    33  	return Open(path, O_CREAT|O_WRONLY|O_TRUNC, mode)
    34  }
    35  
    36  //sys	linkat(olddirfd int, oldpath string, newdirfd int, newpath string, flags int) (err error)
    37  
    38  func Link(oldpath string, newpath string) (err error) {
    39  	return linkat(_AT_FDCWD, oldpath, _AT_FDCWD, newpath, 0)
    40  }
    41  
    42  func Mkdir(path string, mode uint32) (err error) {
    43  	return Mkdirat(_AT_FDCWD, path, mode)
    44  }
    45  
    46  func Mknod(path string, mode uint32, dev int) (err error) {
    47  	return Mknodat(_AT_FDCWD, path, mode, dev)
    48  }
    49  
    50  func Open(path string, mode int, perm uint32) (fd int, err error) {
    51  	return openat(_AT_FDCWD, path, mode|O_LARGEFILE, perm)
    52  }
    53  
    54  //sys	openat(dirfd int, path string, flags int, mode uint32) (fd int, err error)
    55  
    56  func Openat(dirfd int, path string, flags int, mode uint32) (fd int, err error) {
    57  	return openat(dirfd, path, flags|O_LARGEFILE, mode)
    58  }
    59  
    60  //sys	readlinkat(dirfd int, path string, buf []byte) (n int, err error)
    61  
    62  func Readlink(path string, buf []byte) (n int, err error) {
    63  	return readlinkat(_AT_FDCWD, path, buf)
    64  }
    65  
    66  func Rename(oldpath string, newpath string) (err error) {
    67  	return Renameat(_AT_FDCWD, oldpath, _AT_FDCWD, newpath)
    68  }
    69  
    70  func Rmdir(path string) error {
    71  	return unlinkat(_AT_FDCWD, path, _AT_REMOVEDIR)
    72  }
    73  
    74  //sys	symlinkat(oldpath string, newdirfd int, newpath string) (err error)
    75  
    76  func Symlink(oldpath string, newpath string) (err error) {
    77  	return symlinkat(oldpath, _AT_FDCWD, newpath)
    78  }
    79  
    80  func Unlink(path string) error {
    81  	return unlinkat(_AT_FDCWD, path, 0)
    82  }
    83  
    84  //sys	unlinkat(dirfd int, path string, flags int) (err error)
    85  
    86  func Unlinkat(dirfd int, path string) error {
    87  	return unlinkat(dirfd, path, 0)
    88  }
    89  
    90  //sys	utimes(path string, times *[2]Timeval) (err error)
    91  
    92  func Utimes(path string, tv []Timeval) (err error) {
    93  	if len(tv) != 2 {
    94  		return EINVAL
    95  	}
    96  	return utimes(path, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
    97  }
    98  
    99  //sys	utimensat(dirfd int, path string, times *[2]Timespec, flag int) (err error)
   100  
   101  func UtimesNano(path string, ts []Timespec) (err error) {
   102  	if len(ts) != 2 {
   103  		return EINVAL
   104  	}
   105  	err = utimensat(_AT_FDCWD, path, (*[2]Timespec)(unsafe.Pointer(&ts[0])), 0)
   106  	if err != ENOSYS {
   107  		return err
   108  	}
   109  	// If the utimensat syscall isn't available (utimensat was added to Linux
   110  	// in 2.6.22, Released, 8 July 2007) then fall back to utimes
   111  	var tv [2]Timeval
   112  	for i := 0; i < 2; i++ {
   113  		tv[i].Sec = ts[i].Sec
   114  		tv[i].Usec = ts[i].Nsec / 1000
   115  	}
   116  	return utimes(path, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
   117  }
   118  
   119  //sys	futimesat(dirfd int, path *byte, times *[2]Timeval) (err error)
   120  
   121  func Futimesat(dirfd int, path string, tv []Timeval) (err error) {
   122  	if len(tv) != 2 {
   123  		return EINVAL
   124  	}
   125  	pathp, err := BytePtrFromString(path)
   126  	if err != nil {
   127  		return err
   128  	}
   129  	err = futimesat(dirfd, pathp, (*[2]Timeval)(unsafe.Pointer(&tv[0])))
   130  	return err
   131  }
   132  
   133  func Futimes(fd int, tv []Timeval) (err error) {
   134  	// Believe it or not, this is the best we can do on Linux
   135  	// (and is what glibc does).
   136  	return Utimes("/proc/self/fd/"+itoa(fd), tv)
   137  }
   138  
   139  const ImplementsGetwd = true
   140  
   141  //sys	Getcwd(buf []byte) (n int, err error)
   142  
   143  func Getwd() (wd string, err error) {
   144  	var buf [PathMax]byte
   145  	n, err := Getcwd(buf[0:])
   146  	if err != nil {
   147  		return "", err
   148  	}
   149  	// Getcwd returns the number of bytes written to buf, including the NUL.
   150  	if n < 1 || n > len(buf) || buf[n-1] != 0 {
   151  		return "", EINVAL
   152  	}
   153  	return string(buf[0 : n-1]), nil
   154  }
   155  
   156  func Getgroups() (gids []int, err error) {
   157  	n, err := getgroups(0, nil)
   158  	if err != nil {
   159  		return nil, err
   160  	}
   161  	if n == 0 {
   162  		return nil, nil
   163  	}
   164  
   165  	// Sanity check group count. Max is 1<<16 on Linux.
   166  	if n < 0 || n > 1<<20 {
   167  		return nil, EINVAL
   168  	}
   169  
   170  	a := make([]_Gid_t, n)
   171  	n, err = getgroups(n, &a[0])
   172  	if err != nil {
   173  		return nil, err
   174  	}
   175  	gids = make([]int, n)
   176  	for i, v := range a[0:n] {
   177  		gids[i] = int(v)
   178  	}
   179  	return
   180  }
   181  
   182  func Setgroups(gids []int) (err error) {
   183  	if len(gids) == 0 {
   184  		return setgroups(0, nil)
   185  	}
   186  
   187  	a := make([]_Gid_t, len(gids))
   188  	for i, v := range gids {
   189  		a[i] = _Gid_t(v)
   190  	}
   191  	return setgroups(len(a), &a[0])
   192  }
   193  
   194  type WaitStatus uint32
   195  
   196  // Wait status is 7 bits at bottom, either 0 (exited),
   197  // 0x7F (stopped), or a signal number that caused an exit.
   198  // The 0x80 bit is whether there was a core dump.
   199  // An extra number (exit code, signal causing a stop)
   200  // is in the high bits. At least that's the idea.
   201  // There are various irregularities. For example, the
   202  // "continued" status is 0xFFFF, distinguishing itself
   203  // from stopped via the core dump bit.
   204  
   205  const (
   206  	mask    = 0x7F
   207  	core    = 0x80
   208  	exited  = 0x00
   209  	stopped = 0x7F
   210  	shift   = 8
   211  )
   212  
   213  func (w WaitStatus) Exited() bool { return w&mask == exited }
   214  
   215  func (w WaitStatus) Signaled() bool { return w&mask != stopped && w&mask != exited }
   216  
   217  func (w WaitStatus) Stopped() bool { return w&0xFF == stopped }
   218  
   219  func (w WaitStatus) Continued() bool { return w == 0xFFFF }
   220  
   221  func (w WaitStatus) CoreDump() bool { return w.Signaled() && w&core != 0 }
   222  
   223  func (w WaitStatus) ExitStatus() int {
   224  	if !w.Exited() {
   225  		return -1
   226  	}
   227  	return int(w>>shift) & 0xFF
   228  }
   229  
   230  func (w WaitStatus) Signal() Signal {
   231  	if !w.Signaled() {
   232  		return -1
   233  	}
   234  	return Signal(w & mask)
   235  }
   236  
   237  func (w WaitStatus) StopSignal() Signal {
   238  	if !w.Stopped() {
   239  		return -1
   240  	}
   241  	return Signal(w>>shift) & 0xFF
   242  }
   243  
   244  func (w WaitStatus) TrapCause() int {
   245  	if w.StopSignal() != SIGTRAP {
   246  		return -1
   247  	}
   248  	return int(w>>shift) >> 8
   249  }
   250  
   251  //sys	wait4(pid int, wstatus *_C_int, options int, rusage *Rusage) (wpid int, err error)
   252  
   253  func Wait4(pid int, wstatus *WaitStatus, options int, rusage *Rusage) (wpid int, err error) {
   254  	var status _C_int
   255  	wpid, err = wait4(pid, &status, options, rusage)
   256  	if wstatus != nil {
   257  		*wstatus = WaitStatus(status)
   258  	}
   259  	return
   260  }
   261  
   262  func Mkfifo(path string, mode uint32) (err error) {
   263  	return Mknod(path, mode|S_IFIFO, 0)
   264  }
   265  
   266  func (sa *SockaddrInet4) sockaddr() (unsafe.Pointer, _Socklen, error) {
   267  	if sa.Port < 0 || sa.Port > 0xFFFF {
   268  		return nil, 0, EINVAL
   269  	}
   270  	sa.raw.Family = AF_INET
   271  	p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
   272  	p[0] = byte(sa.Port >> 8)
   273  	p[1] = byte(sa.Port)
   274  	for i := 0; i < len(sa.Addr); i++ {
   275  		sa.raw.Addr[i] = sa.Addr[i]
   276  	}
   277  	return unsafe.Pointer(&sa.raw), SizeofSockaddrInet4, nil
   278  }
   279  
   280  func (sa *SockaddrInet6) sockaddr() (unsafe.Pointer, _Socklen, error) {
   281  	if sa.Port < 0 || sa.Port > 0xFFFF {
   282  		return nil, 0, EINVAL
   283  	}
   284  	sa.raw.Family = AF_INET6
   285  	p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
   286  	p[0] = byte(sa.Port >> 8)
   287  	p[1] = byte(sa.Port)
   288  	sa.raw.Scope_id = sa.ZoneId
   289  	for i := 0; i < len(sa.Addr); i++ {
   290  		sa.raw.Addr[i] = sa.Addr[i]
   291  	}
   292  	return unsafe.Pointer(&sa.raw), SizeofSockaddrInet6, nil
   293  }
   294  
   295  func (sa *SockaddrUnix) sockaddr() (unsafe.Pointer, _Socklen, error) {
   296  	name := sa.Name
   297  	n := len(name)
   298  	if n >= len(sa.raw.Path) {
   299  		return nil, 0, EINVAL
   300  	}
   301  	sa.raw.Family = AF_UNIX
   302  	for i := 0; i < n; i++ {
   303  		sa.raw.Path[i] = int8(name[i])
   304  	}
   305  	// length is family (uint16), name, NUL.
   306  	sl := _Socklen(2)
   307  	if n > 0 {
   308  		sl += _Socklen(n) + 1
   309  	}
   310  	if sa.raw.Path[0] == '@' {
   311  		sa.raw.Path[0] = 0
   312  		// Don't count trailing NUL for abstract address.
   313  		sl--
   314  	}
   315  
   316  	return unsafe.Pointer(&sa.raw), sl, nil
   317  }
   318  
   319  type SockaddrLinklayer struct {
   320  	Protocol uint16
   321  	Ifindex  int
   322  	Hatype   uint16
   323  	Pkttype  uint8
   324  	Halen    uint8
   325  	Addr     [8]byte
   326  	raw      RawSockaddrLinklayer
   327  }
   328  
   329  func (sa *SockaddrLinklayer) sockaddr() (unsafe.Pointer, _Socklen, error) {
   330  	if sa.Ifindex < 0 || sa.Ifindex > 0x7fffffff {
   331  		return nil, 0, EINVAL
   332  	}
   333  	sa.raw.Family = AF_PACKET
   334  	sa.raw.Protocol = sa.Protocol
   335  	sa.raw.Ifindex = int32(sa.Ifindex)
   336  	sa.raw.Hatype = sa.Hatype
   337  	sa.raw.Pkttype = sa.Pkttype
   338  	sa.raw.Halen = sa.Halen
   339  	for i := 0; i < len(sa.Addr); i++ {
   340  		sa.raw.Addr[i] = sa.Addr[i]
   341  	}
   342  	return unsafe.Pointer(&sa.raw), SizeofSockaddrLinklayer, nil
   343  }
   344  
   345  type SockaddrNetlink struct {
   346  	Family uint16
   347  	Pad    uint16
   348  	Pid    uint32
   349  	Groups uint32
   350  	raw    RawSockaddrNetlink
   351  }
   352  
   353  func (sa *SockaddrNetlink) sockaddr() (unsafe.Pointer, _Socklen, error) {
   354  	sa.raw.Family = AF_NETLINK
   355  	sa.raw.Pad = sa.Pad
   356  	sa.raw.Pid = sa.Pid
   357  	sa.raw.Groups = sa.Groups
   358  	return unsafe.Pointer(&sa.raw), SizeofSockaddrNetlink, nil
   359  }
   360  
   361  func anyToSockaddr(rsa *RawSockaddrAny) (Sockaddr, error) {
   362  	switch rsa.Addr.Family {
   363  	case AF_NETLINK:
   364  		pp := (*RawSockaddrNetlink)(unsafe.Pointer(rsa))
   365  		sa := new(SockaddrNetlink)
   366  		sa.Family = pp.Family
   367  		sa.Pad = pp.Pad
   368  		sa.Pid = pp.Pid
   369  		sa.Groups = pp.Groups
   370  		return sa, nil
   371  
   372  	case AF_PACKET:
   373  		pp := (*RawSockaddrLinklayer)(unsafe.Pointer(rsa))
   374  		sa := new(SockaddrLinklayer)
   375  		sa.Protocol = pp.Protocol
   376  		sa.Ifindex = int(pp.Ifindex)
   377  		sa.Hatype = pp.Hatype
   378  		sa.Pkttype = pp.Pkttype
   379  		sa.Halen = pp.Halen
   380  		for i := 0; i < len(sa.Addr); i++ {
   381  			sa.Addr[i] = pp.Addr[i]
   382  		}
   383  		return sa, nil
   384  
   385  	case AF_UNIX:
   386  		pp := (*RawSockaddrUnix)(unsafe.Pointer(rsa))
   387  		sa := new(SockaddrUnix)
   388  		if pp.Path[0] == 0 {
   389  			// "Abstract" Unix domain socket.
   390  			// Rewrite leading NUL as @ for textual display.
   391  			// (This is the standard convention.)
   392  			// Not friendly to overwrite in place,
   393  			// but the callers below don't care.
   394  			pp.Path[0] = '@'
   395  		}
   396  
   397  		// Assume path ends at NUL.
   398  		// This is not technically the Linux semantics for
   399  		// abstract Unix domain sockets--they are supposed
   400  		// to be uninterpreted fixed-size binary blobs--but
   401  		// everyone uses this convention.
   402  		n := 0
   403  		for n < len(pp.Path) && pp.Path[n] != 0 {
   404  			n++
   405  		}
   406  		bytes := (*[10000]byte)(unsafe.Pointer(&pp.Path[0]))[0:n]
   407  		sa.Name = string(bytes)
   408  		return sa, nil
   409  
   410  	case AF_INET:
   411  		pp := (*RawSockaddrInet4)(unsafe.Pointer(rsa))
   412  		sa := new(SockaddrInet4)
   413  		p := (*[2]byte)(unsafe.Pointer(&pp.Port))
   414  		sa.Port = int(p[0])<<8 + int(p[1])
   415  		for i := 0; i < len(sa.Addr); i++ {
   416  			sa.Addr[i] = pp.Addr[i]
   417  		}
   418  		return sa, nil
   419  
   420  	case AF_INET6:
   421  		pp := (*RawSockaddrInet6)(unsafe.Pointer(rsa))
   422  		sa := new(SockaddrInet6)
   423  		p := (*[2]byte)(unsafe.Pointer(&pp.Port))
   424  		sa.Port = int(p[0])<<8 + int(p[1])
   425  		sa.ZoneId = pp.Scope_id
   426  		for i := 0; i < len(sa.Addr); i++ {
   427  			sa.Addr[i] = pp.Addr[i]
   428  		}
   429  		return sa, nil
   430  	}
   431  	return nil, EAFNOSUPPORT
   432  }
   433  
   434  func Accept(fd int) (nfd int, sa Sockaddr, err error) {
   435  	var rsa RawSockaddrAny
   436  	var len _Socklen = SizeofSockaddrAny
   437  	nfd, err = accept(fd, &rsa, &len)
   438  	if err != nil {
   439  		return
   440  	}
   441  	sa, err = anyToSockaddr(&rsa)
   442  	if err != nil {
   443  		Close(nfd)
   444  		nfd = 0
   445  	}
   446  	return
   447  }
   448  
   449  func Accept4(fd int, flags int) (nfd int, sa Sockaddr, err error) {
   450  	var rsa RawSockaddrAny
   451  	var len _Socklen = SizeofSockaddrAny
   452  	nfd, err = accept4(fd, &rsa, &len, flags)
   453  	if err != nil {
   454  		return
   455  	}
   456  	if len > SizeofSockaddrAny {
   457  		panic("RawSockaddrAny too small")
   458  	}
   459  	sa, err = anyToSockaddr(&rsa)
   460  	if err != nil {
   461  		Close(nfd)
   462  		nfd = 0
   463  	}
   464  	return
   465  }
   466  
   467  func Getsockname(fd int) (sa Sockaddr, err error) {
   468  	var rsa RawSockaddrAny
   469  	var len _Socklen = SizeofSockaddrAny
   470  	if err = getsockname(fd, &rsa, &len); err != nil {
   471  		return
   472  	}
   473  	return anyToSockaddr(&rsa)
   474  }
   475  
   476  func GetsockoptInet4Addr(fd, level, opt int) (value [4]byte, err error) {
   477  	vallen := _Socklen(4)
   478  	err = getsockopt(fd, level, opt, unsafe.Pointer(&value[0]), &vallen)
   479  	return value, err
   480  }
   481  
   482  func GetsockoptIPMreq(fd, level, opt int) (*IPMreq, error) {
   483  	var value IPMreq
   484  	vallen := _Socklen(SizeofIPMreq)
   485  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   486  	return &value, err
   487  }
   488  
   489  func GetsockoptIPMreqn(fd, level, opt int) (*IPMreqn, error) {
   490  	var value IPMreqn
   491  	vallen := _Socklen(SizeofIPMreqn)
   492  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   493  	return &value, err
   494  }
   495  
   496  func GetsockoptIPv6Mreq(fd, level, opt int) (*IPv6Mreq, error) {
   497  	var value IPv6Mreq
   498  	vallen := _Socklen(SizeofIPv6Mreq)
   499  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   500  	return &value, err
   501  }
   502  
   503  func GetsockoptIPv6MTUInfo(fd, level, opt int) (*IPv6MTUInfo, error) {
   504  	var value IPv6MTUInfo
   505  	vallen := _Socklen(SizeofIPv6MTUInfo)
   506  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   507  	return &value, err
   508  }
   509  
   510  func GetsockoptICMPv6Filter(fd, level, opt int) (*ICMPv6Filter, error) {
   511  	var value ICMPv6Filter
   512  	vallen := _Socklen(SizeofICMPv6Filter)
   513  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   514  	return &value, err
   515  }
   516  
   517  func GetsockoptUcred(fd, level, opt int) (*Ucred, error) {
   518  	var value Ucred
   519  	vallen := _Socklen(SizeofUcred)
   520  	err := getsockopt(fd, level, opt, unsafe.Pointer(&value), &vallen)
   521  	return &value, err
   522  }
   523  
   524  func SetsockoptIPMreqn(fd, level, opt int, mreq *IPMreqn) (err error) {
   525  	return setsockopt(fd, level, opt, unsafe.Pointer(mreq), unsafe.Sizeof(*mreq))
   526  }
   527  
   528  func Recvmsg(fd int, p, oob []byte, flags int) (n, oobn int, recvflags int, from Sockaddr, err error) {
   529  	var msg Msghdr
   530  	var rsa RawSockaddrAny
   531  	msg.Name = (*byte)(unsafe.Pointer(&rsa))
   532  	msg.Namelen = uint32(SizeofSockaddrAny)
   533  	var iov Iovec
   534  	if len(p) > 0 {
   535  		iov.Base = (*byte)(unsafe.Pointer(&p[0]))
   536  		iov.SetLen(len(p))
   537  	}
   538  	var dummy byte
   539  	if len(oob) > 0 {
   540  		var sockType int
   541  		sockType, err = GetsockoptInt(fd, SOL_SOCKET, SO_TYPE)
   542  		if err != nil {
   543  			return
   544  		}
   545  		// receive at least one normal byte
   546  		if sockType != SOCK_DGRAM && len(p) == 0 {
   547  			iov.Base = &dummy
   548  			iov.SetLen(1)
   549  		}
   550  		msg.Control = (*byte)(unsafe.Pointer(&oob[0]))
   551  		msg.SetControllen(len(oob))
   552  	}
   553  	msg.Iov = &iov
   554  	msg.Iovlen = 1
   555  	if n, err = recvmsg(fd, &msg, flags); err != nil {
   556  		return
   557  	}
   558  	oobn = int(msg.Controllen)
   559  	recvflags = int(msg.Flags)
   560  	// source address is only specified if the socket is unconnected
   561  	if rsa.Addr.Family != AF_UNSPEC {
   562  		from, err = anyToSockaddr(&rsa)
   563  	}
   564  	return
   565  }
   566  
   567  func Sendmsg(fd int, p, oob []byte, to Sockaddr, flags int) (err error) {
   568  	_, err = SendmsgN(fd, p, oob, to, flags)
   569  	return
   570  }
   571  
   572  func SendmsgN(fd int, p, oob []byte, to Sockaddr, flags int) (n int, err error) {
   573  	var ptr unsafe.Pointer
   574  	var salen _Socklen
   575  	if to != nil {
   576  		var err error
   577  		ptr, salen, err = to.sockaddr()
   578  		if err != nil {
   579  			return 0, err
   580  		}
   581  	}
   582  	var msg Msghdr
   583  	msg.Name = (*byte)(unsafe.Pointer(ptr))
   584  	msg.Namelen = uint32(salen)
   585  	var iov Iovec
   586  	if len(p) > 0 {
   587  		iov.Base = (*byte)(unsafe.Pointer(&p[0]))
   588  		iov.SetLen(len(p))
   589  	}
   590  	var dummy byte
   591  	if len(oob) > 0 {
   592  		var sockType int
   593  		sockType, err = GetsockoptInt(fd, SOL_SOCKET, SO_TYPE)
   594  		if err != nil {
   595  			return 0, err
   596  		}
   597  		// send at least one normal byte
   598  		if sockType != SOCK_DGRAM && len(p) == 0 {
   599  			iov.Base = &dummy
   600  			iov.SetLen(1)
   601  		}
   602  		msg.Control = (*byte)(unsafe.Pointer(&oob[0]))
   603  		msg.SetControllen(len(oob))
   604  	}
   605  	msg.Iov = &iov
   606  	msg.Iovlen = 1
   607  	if n, err = sendmsg(fd, &msg, flags); err != nil {
   608  		return 0, err
   609  	}
   610  	if len(oob) > 0 && len(p) == 0 {
   611  		n = 0
   612  	}
   613  	return n, nil
   614  }
   615  
   616  // BindToDevice binds the socket associated with fd to device.
   617  func BindToDevice(fd int, device string) (err error) {
   618  	return SetsockoptString(fd, SOL_SOCKET, SO_BINDTODEVICE, device)
   619  }
   620  
   621  //sys	ptrace(request int, pid int, addr uintptr, data uintptr) (err error)
   622  
   623  func ptracePeek(req int, pid int, addr uintptr, out []byte) (count int, err error) {
   624  	// The peek requests are machine-size oriented, so we wrap it
   625  	// to retrieve arbitrary-length data.
   626  
   627  	// The ptrace syscall differs from glibc's ptrace.
   628  	// Peeks returns the word in *data, not as the return value.
   629  
   630  	var buf [sizeofPtr]byte
   631  
   632  	// Leading edge. PEEKTEXT/PEEKDATA don't require aligned
   633  	// access (PEEKUSER warns that it might), but if we don't
   634  	// align our reads, we might straddle an unmapped page
   635  	// boundary and not get the bytes leading up to the page
   636  	// boundary.
   637  	n := 0
   638  	if addr%sizeofPtr != 0 {
   639  		err = ptrace(req, pid, addr-addr%sizeofPtr, uintptr(unsafe.Pointer(&buf[0])))
   640  		if err != nil {
   641  			return 0, err
   642  		}
   643  		n += copy(out, buf[addr%sizeofPtr:])
   644  		out = out[n:]
   645  	}
   646  
   647  	// Remainder.
   648  	for len(out) > 0 {
   649  		// We use an internal buffer to guarantee alignment.
   650  		// It's not documented if this is necessary, but we're paranoid.
   651  		err = ptrace(req, pid, addr+uintptr(n), uintptr(unsafe.Pointer(&buf[0])))
   652  		if err != nil {
   653  			return n, err
   654  		}
   655  		copied := copy(out, buf[0:])
   656  		n += copied
   657  		out = out[copied:]
   658  	}
   659  
   660  	return n, nil
   661  }
   662  
   663  func PtracePeekText(pid int, addr uintptr, out []byte) (count int, err error) {
   664  	return ptracePeek(PTRACE_PEEKTEXT, pid, addr, out)
   665  }
   666  
   667  func PtracePeekData(pid int, addr uintptr, out []byte) (count int, err error) {
   668  	return ptracePeek(PTRACE_PEEKDATA, pid, addr, out)
   669  }
   670  
   671  func ptracePoke(pokeReq int, peekReq int, pid int, addr uintptr, data []byte) (count int, err error) {
   672  	// As for ptracePeek, we need to align our accesses to deal
   673  	// with the possibility of straddling an invalid page.
   674  
   675  	// Leading edge.
   676  	n := 0
   677  	if addr%sizeofPtr != 0 {
   678  		var buf [sizeofPtr]byte
   679  		err = ptrace(peekReq, pid, addr-addr%sizeofPtr, uintptr(unsafe.Pointer(&buf[0])))
   680  		if err != nil {
   681  			return 0, err
   682  		}
   683  		n += copy(buf[addr%sizeofPtr:], data)
   684  		word := *((*uintptr)(unsafe.Pointer(&buf[0])))
   685  		err = ptrace(pokeReq, pid, addr-addr%sizeofPtr, word)
   686  		if err != nil {
   687  			return 0, err
   688  		}
   689  		data = data[n:]
   690  	}
   691  
   692  	// Interior.
   693  	for len(data) > sizeofPtr {
   694  		word := *((*uintptr)(unsafe.Pointer(&data[0])))
   695  		err = ptrace(pokeReq, pid, addr+uintptr(n), word)
   696  		if err != nil {
   697  			return n, err
   698  		}
   699  		n += sizeofPtr
   700  		data = data[sizeofPtr:]
   701  	}
   702  
   703  	// Trailing edge.
   704  	if len(data) > 0 {
   705  		var buf [sizeofPtr]byte
   706  		err = ptrace(peekReq, pid, addr+uintptr(n), uintptr(unsafe.Pointer(&buf[0])))
   707  		if err != nil {
   708  			return n, err
   709  		}
   710  		copy(buf[0:], data)
   711  		word := *((*uintptr)(unsafe.Pointer(&buf[0])))
   712  		err = ptrace(pokeReq, pid, addr+uintptr(n), word)
   713  		if err != nil {
   714  			return n, err
   715  		}
   716  		n += len(data)
   717  	}
   718  
   719  	return n, nil
   720  }
   721  
   722  func PtracePokeText(pid int, addr uintptr, data []byte) (count int, err error) {
   723  	return ptracePoke(PTRACE_POKETEXT, PTRACE_PEEKTEXT, pid, addr, data)
   724  }
   725  
   726  func PtracePokeData(pid int, addr uintptr, data []byte) (count int, err error) {
   727  	return ptracePoke(PTRACE_POKEDATA, PTRACE_PEEKDATA, pid, addr, data)
   728  }
   729  
   730  func PtraceGetRegs(pid int, regsout *PtraceRegs) (err error) {
   731  	return ptrace(PTRACE_GETREGS, pid, 0, uintptr(unsafe.Pointer(regsout)))
   732  }
   733  
   734  func PtraceSetRegs(pid int, regs *PtraceRegs) (err error) {
   735  	return ptrace(PTRACE_SETREGS, pid, 0, uintptr(unsafe.Pointer(regs)))
   736  }
   737  
   738  func PtraceSetOptions(pid int, options int) (err error) {
   739  	return ptrace(PTRACE_SETOPTIONS, pid, 0, uintptr(options))
   740  }
   741  
   742  func PtraceGetEventMsg(pid int) (msg uint, err error) {
   743  	var data _C_long
   744  	err = ptrace(PTRACE_GETEVENTMSG, pid, 0, uintptr(unsafe.Pointer(&data)))
   745  	msg = uint(data)
   746  	return
   747  }
   748  
   749  func PtraceCont(pid int, signal int) (err error) {
   750  	return ptrace(PTRACE_CONT, pid, 0, uintptr(signal))
   751  }
   752  
   753  func PtraceSyscall(pid int, signal int) (err error) {
   754  	return ptrace(PTRACE_SYSCALL, pid, 0, uintptr(signal))
   755  }
   756  
   757  func PtraceSingleStep(pid int) (err error) { return ptrace(PTRACE_SINGLESTEP, pid, 0, 0) }
   758  
   759  func PtraceAttach(pid int) (err error) { return ptrace(PTRACE_ATTACH, pid, 0, 0) }
   760  
   761  func PtraceDetach(pid int) (err error) { return ptrace(PTRACE_DETACH, pid, 0, 0) }
   762  
   763  //sys	reboot(magic1 uint, magic2 uint, cmd int, arg string) (err error)
   764  
   765  func Reboot(cmd int) (err error) {
   766  	return reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2, cmd, "")
   767  }
   768  
   769  func ReadDirent(fd int, buf []byte) (n int, err error) {
   770  	return Getdents(fd, buf)
   771  }
   772  
   773  func direntIno(buf []byte) (uint64, bool) {
   774  	return readInt(buf, unsafe.Offsetof(Dirent{}.Ino), unsafe.Sizeof(Dirent{}.Ino))
   775  }
   776  
   777  func direntReclen(buf []byte) (uint64, bool) {
   778  	return readInt(buf, unsafe.Offsetof(Dirent{}.Reclen), unsafe.Sizeof(Dirent{}.Reclen))
   779  }
   780  
   781  func direntNamlen(buf []byte) (uint64, bool) {
   782  	reclen, ok := direntReclen(buf)
   783  	if !ok {
   784  		return 0, false
   785  	}
   786  	return reclen - uint64(unsafe.Offsetof(Dirent{}.Name)), true
   787  }
   788  
   789  //sys	mount(source string, target string, fstype string, flags uintptr, data *byte) (err error)
   790  
   791  func Mount(source string, target string, fstype string, flags uintptr, data string) (err error) {
   792  	// Certain file systems get rather angry and EINVAL if you give
   793  	// them an empty string of data, rather than NULL.
   794  	if data == "" {
   795  		return mount(source, target, fstype, flags, nil)
   796  	}
   797  	datap, err := BytePtrFromString(data)
   798  	if err != nil {
   799  		return err
   800  	}
   801  	err = mount(source, target, fstype, flags, datap)
   802  	return err
   803  }
   804  
   805  // Sendto
   806  // Recvfrom
   807  // Socketpair
   808  
   809  /*
   810   * Direct access
   811   */
   812  //sys	Acct(path string) (err error)
   813  //sys	Adjtimex(buf *Timex) (state int, err error)
   814  //sys	Chdir(path string) (err error)
   815  //sys	Chroot(path string) (err error)
   816  //sys	Close(fd int) (err error)
   817  //sys	Dup(oldfd int) (fd int, err error)
   818  //sys	Dup3(oldfd int, newfd int, flags int) (err error)
   819  //sysnb	EpollCreate(size int) (fd int, err error)
   820  //sysnb	EpollCreate1(flag int) (fd int, err error)
   821  //sysnb	EpollCtl(epfd int, op int, fd int, event *EpollEvent) (err error)
   822  //sys	EpollWait(epfd int, events []EpollEvent, msec int) (n int, err error)
   823  //sys	Exit(code int) = SYS_EXIT_GROUP
   824  //sys	Faccessat(dirfd int, path string, mode uint32, flags int) (err error)
   825  //sys	Fallocate(fd int, mode uint32, off int64, len int64) (err error)
   826  //sys	Fchdir(fd int) (err error)
   827  //sys	Fchmod(fd int, mode uint32) (err error)
   828  //sys	Fchmodat(dirfd int, path string, mode uint32, flags int) (err error)
   829  //sys	Fchownat(dirfd int, path string, uid int, gid int, flags int) (err error)
   830  //sys	fcntl(fd int, cmd int, arg int) (val int, err error)
   831  //sys	Fdatasync(fd int) (err error)
   832  //sys	Flock(fd int, how int) (err error)
   833  //sys	Fsync(fd int) (err error)
   834  //sys	Getdents(fd int, buf []byte) (n int, err error) = _SYS_getdents
   835  //sysnb	Getpgid(pid int) (pgid int, err error)
   836  
   837  func Getpgrp() (pid int) {
   838  	pid, _ = Getpgid(0)
   839  	return
   840  }
   841  
   842  //sysnb	Getpid() (pid int)
   843  //sysnb	Getppid() (ppid int)
   844  //sys	Getpriority(which int, who int) (prio int, err error)
   845  //sysnb	Getrusage(who int, rusage *Rusage) (err error)
   846  //sysnb	Gettid() (tid int)
   847  //sys	Getxattr(path string, attr string, dest []byte) (sz int, err error)
   848  //sys	InotifyAddWatch(fd int, pathname string, mask uint32) (watchdesc int, err error)
   849  //sysnb	InotifyInit1(flags int) (fd int, err error)
   850  //sysnb	InotifyRmWatch(fd int, watchdesc uint32) (success int, err error)
   851  //sysnb	Kill(pid int, sig Signal) (err error)
   852  //sys	Klogctl(typ int, buf []byte) (n int, err error) = SYS_SYSLOG
   853  //sys	Listxattr(path string, dest []byte) (sz int, err error)
   854  //sys	Mkdirat(dirfd int, path string, mode uint32) (err error)
   855  //sys	Mknodat(dirfd int, path string, mode uint32, dev int) (err error)
   856  //sys	Nanosleep(time *Timespec, leftover *Timespec) (err error)
   857  //sys	Pause() (err error)
   858  //sys	PivotRoot(newroot string, putold string) (err error) = SYS_PIVOT_ROOT
   859  //sysnb prlimit(pid int, resource int, newlimit *Rlimit, old *Rlimit) (err error) = SYS_PRLIMIT64
   860  //sys	read(fd int, p []byte) (n int, err error)
   861  //sys	Removexattr(path string, attr string) (err error)
   862  //sys	Renameat(olddirfd int, oldpath string, newdirfd int, newpath string) (err error)
   863  //sys	Setdomainname(p []byte) (err error)
   864  //sys	Sethostname(p []byte) (err error)
   865  //sysnb	Setpgid(pid int, pgid int) (err error)
   866  //sysnb	Setsid() (pid int, err error)
   867  //sysnb	Settimeofday(tv *Timeval) (err error)
   868  
   869  // issue 1435.
   870  // On linux Setuid and Setgid only affects the current thread, not the process.
   871  // This does not match what most callers expect so we must return an error
   872  // here rather than letting the caller think that the call succeeded.
   873  
   874  func Setuid(uid int) (err error) {
   875  	return EOPNOTSUPP
   876  }
   877  
   878  func Setgid(gid int) (err error) {
   879  	return EOPNOTSUPP
   880  }
   881  
   882  //sys	Setpriority(which int, who int, prio int) (err error)
   883  //sys	Setxattr(path string, attr string, data []byte, flags int) (err error)
   884  //sys	Sync()
   885  //sysnb	Sysinfo(info *Sysinfo_t) (err error)
   886  //sys	Tee(rfd int, wfd int, len int, flags int) (n int64, err error)
   887  //sysnb	Tgkill(tgid int, tid int, sig Signal) (err error)
   888  //sysnb	Times(tms *Tms) (ticks uintptr, err error)
   889  //sysnb	Umask(mask int) (oldmask int)
   890  //sysnb	Uname(buf *Utsname) (err error)
   891  //sys	Unmount(target string, flags int) (err error) = SYS_UMOUNT2
   892  //sys	Unshare(flags int) (err error)
   893  //sys	Ustat(dev int, ubuf *Ustat_t) (err error)
   894  //sys	Utime(path string, buf *Utimbuf) (err error)
   895  //sys	write(fd int, p []byte) (n int, err error)
   896  //sys	exitThread(code int) (err error) = SYS_EXIT
   897  //sys	readlen(fd int, p *byte, np int) (n int, err error) = SYS_READ
   898  //sys	writelen(fd int, p *byte, np int) (n int, err error) = SYS_WRITE
   899  
   900  // mmap varies by architecture; see syscall_linux_*.go.
   901  //sys	munmap(addr uintptr, length uintptr) (err error)
   902  
   903  var mapper = &mmapper{
   904  	active: make(map[*byte][]byte),
   905  	mmap:   mmap,
   906  	munmap: munmap,
   907  }
   908  
   909  func Mmap(fd int, offset int64, length int, prot int, flags int) (data []byte, err error) {
   910  	return mapper.Mmap(fd, offset, length, prot, flags)
   911  }
   912  
   913  func Munmap(b []byte) (err error) {
   914  	return mapper.Munmap(b)
   915  }
   916  
   917  //sys	Madvise(b []byte, advice int) (err error)
   918  //sys	Mprotect(b []byte, prot int) (err error)
   919  //sys	Mlock(b []byte) (err error)
   920  //sys	Munlock(b []byte) (err error)
   921  //sys	Mlockall(flags int) (err error)
   922  //sys	Munlockall() (err error)
   923  
   924  /*
   925   * Unimplemented
   926   */
   927  // AddKey
   928  // AfsSyscall
   929  // Alarm
   930  // ArchPrctl
   931  // Brk
   932  // Capget
   933  // Capset
   934  // ClockGetres
   935  // ClockGettime
   936  // ClockNanosleep
   937  // ClockSettime
   938  // Clone
   939  // CreateModule
   940  // DeleteModule
   941  // EpollCtlOld
   942  // EpollPwait
   943  // EpollWaitOld
   944  // Eventfd
   945  // Execve
   946  // Fadvise64
   947  // Fgetxattr
   948  // Flistxattr
   949  // Fork
   950  // Fremovexattr
   951  // Fsetxattr
   952  // Futex
   953  // GetKernelSyms
   954  // GetMempolicy
   955  // GetRobustList
   956  // GetThreadArea
   957  // Getitimer
   958  // Getpmsg
   959  // IoCancel
   960  // IoDestroy
   961  // IoGetevents
   962  // IoSetup
   963  // IoSubmit
   964  // Ioctl
   965  // IoprioGet
   966  // IoprioSet
   967  // KexecLoad
   968  // Keyctl
   969  // Lgetxattr
   970  // Llistxattr
   971  // LookupDcookie
   972  // Lremovexattr
   973  // Lsetxattr
   974  // Mbind
   975  // MigratePages
   976  // Mincore
   977  // ModifyLdt
   978  // Mount
   979  // MovePages
   980  // Mprotect
   981  // MqGetsetattr
   982  // MqNotify
   983  // MqOpen
   984  // MqTimedreceive
   985  // MqTimedsend
   986  // MqUnlink
   987  // Mremap
   988  // Msgctl
   989  // Msgget
   990  // Msgrcv
   991  // Msgsnd
   992  // Msync
   993  // Newfstatat
   994  // Nfsservctl
   995  // Personality
   996  // Poll
   997  // Ppoll
   998  // Prctl
   999  // Pselect6
  1000  // Ptrace
  1001  // Putpmsg
  1002  // QueryModule
  1003  // Quotactl
  1004  // Readahead
  1005  // Readv
  1006  // RemapFilePages
  1007  // RequestKey
  1008  // RestartSyscall
  1009  // RtSigaction
  1010  // RtSigpending
  1011  // RtSigprocmask
  1012  // RtSigqueueinfo
  1013  // RtSigreturn
  1014  // RtSigsuspend
  1015  // RtSigtimedwait
  1016  // SchedGetPriorityMax
  1017  // SchedGetPriorityMin
  1018  // SchedGetaffinity
  1019  // SchedGetparam
  1020  // SchedGetscheduler
  1021  // SchedRrGetInterval
  1022  // SchedSetaffinity
  1023  // SchedSetparam
  1024  // SchedYield
  1025  // Security
  1026  // Semctl
  1027  // Semget
  1028  // Semop
  1029  // Semtimedop
  1030  // SetMempolicy
  1031  // SetRobustList
  1032  // SetThreadArea
  1033  // SetTidAddress
  1034  // Shmat
  1035  // Shmctl
  1036  // Shmdt
  1037  // Shmget
  1038  // Sigaltstack
  1039  // Signalfd
  1040  // Swapoff
  1041  // Swapon
  1042  // Sysfs
  1043  // TimerCreate
  1044  // TimerDelete
  1045  // TimerGetoverrun
  1046  // TimerGettime
  1047  // TimerSettime
  1048  // Timerfd
  1049  // Tkill (obsolete)
  1050  // Tuxcall
  1051  // Umount2
  1052  // Uselib
  1053  // Utimensat
  1054  // Vfork
  1055  // Vhangup
  1056  // Vmsplice
  1057  // Vserver
  1058  // Waitid
  1059  // _Sysctl