Scott Baker | 2d89798 | 2019-09-24 11:50:08 -0700 | [diff] [blame] | 1 | // Copyright 2018 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 | // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris |
| 6 | |
| 7 | package unix |
| 8 | |
Scott Baker | 8487c5d | 2019-10-18 12:49:46 -0700 | [diff] [blame] | 9 | import ( |
| 10 | "runtime" |
| 11 | "unsafe" |
| 12 | ) |
| 13 | |
| 14 | // ioctl itself should not be exposed directly, but additional get/set |
| 15 | // functions for specific types are permissible. |
| 16 | |
| 17 | // IoctlSetInt performs an ioctl operation which sets an integer value |
| 18 | // on fd, using the specified request number. |
| 19 | func IoctlSetInt(fd int, req uint, value int) error { |
| 20 | return ioctl(fd, req, uintptr(value)) |
| 21 | } |
Scott Baker | 2d89798 | 2019-09-24 11:50:08 -0700 | [diff] [blame] | 22 | |
| 23 | // IoctlSetWinsize performs an ioctl on fd with a *Winsize argument. |
| 24 | // |
| 25 | // To change fd's window size, the req argument should be TIOCSWINSZ. |
| 26 | func IoctlSetWinsize(fd int, req uint, value *Winsize) error { |
| 27 | // TODO: if we get the chance, remove the req parameter and |
| 28 | // hardcode TIOCSWINSZ. |
Scott Baker | 8487c5d | 2019-10-18 12:49:46 -0700 | [diff] [blame] | 29 | err := ioctl(fd, req, uintptr(unsafe.Pointer(value))) |
Scott Baker | 2d89798 | 2019-09-24 11:50:08 -0700 | [diff] [blame] | 30 | runtime.KeepAlive(value) |
| 31 | return err |
| 32 | } |
| 33 | |
| 34 | // IoctlSetTermios performs an ioctl on fd with a *Termios. |
| 35 | // |
| 36 | // The req value will usually be TCSETA or TIOCSETA. |
| 37 | func IoctlSetTermios(fd int, req uint, value *Termios) error { |
| 38 | // TODO: if we get the chance, remove the req parameter. |
Scott Baker | 8487c5d | 2019-10-18 12:49:46 -0700 | [diff] [blame] | 39 | err := ioctl(fd, req, uintptr(unsafe.Pointer(value))) |
Scott Baker | 2d89798 | 2019-09-24 11:50:08 -0700 | [diff] [blame] | 40 | runtime.KeepAlive(value) |
| 41 | return err |
| 42 | } |
Scott Baker | 8487c5d | 2019-10-18 12:49:46 -0700 | [diff] [blame] | 43 | |
| 44 | // IoctlGetInt performs an ioctl operation which gets an integer value |
| 45 | // from fd, using the specified request number. |
| 46 | // |
| 47 | // A few ioctl requests use the return value as an output parameter; |
| 48 | // for those, IoctlRetInt should be used instead of this function. |
| 49 | func IoctlGetInt(fd int, req uint) (int, error) { |
| 50 | var value int |
| 51 | err := ioctl(fd, req, uintptr(unsafe.Pointer(&value))) |
| 52 | return value, err |
| 53 | } |
| 54 | |
| 55 | func IoctlGetWinsize(fd int, req uint) (*Winsize, error) { |
| 56 | var value Winsize |
| 57 | err := ioctl(fd, req, uintptr(unsafe.Pointer(&value))) |
| 58 | return &value, err |
| 59 | } |
| 60 | |
| 61 | func IoctlGetTermios(fd int, req uint) (*Termios, error) { |
| 62 | var value Termios |
| 63 | err := ioctl(fd, req, uintptr(unsafe.Pointer(&value))) |
| 64 | return &value, err |
| 65 | } |