blob: f8813ce6becd019f5b2aa3b3c776808915bac9e7 [file] [log] [blame]
// Copyright 2017 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
// +build aix darwin dragonfly freebsd linux,!android netbsd openbsd
// +build cgo
// Package pty is a simple pseudo-terminal package for Unix systems,
// implemented by calling C functions via cgo.
// This is only used for testing the os/signal package.
package pty
#define _XOPEN_SOURCE 600
#include <fcntl.h>
#include <stdlib.h>
#include <unistd.h>
import "C"
import (
type PtyError struct {
FuncName string
ErrorString string
Errno syscall.Errno
func ptyError(name string, err error) *PtyError {
return &PtyError{name, err.Error(), err.(syscall.Errno)}
func (e *PtyError) Error() string {
return fmt.Sprintf("%s: %s", e.FuncName, e.ErrorString)
func (e *PtyError) Unwrap() error { return e.Errno }
// Open returns a control pty and the name of the linked process tty.
func Open() (pty *os.File, processTTY string, err error) {
m, err := C.posix_openpt(C.O_RDWR)
if err != nil {
return nil, "", ptyError("posix_openpt", err)
if _, err := C.grantpt(m); err != nil {
return nil, "", ptyError("grantpt", err)
if _, err := C.unlockpt(m); err != nil {
return nil, "", ptyError("unlockpt", err)
processTTY = C.GoString(C.ptsname(m))
return os.NewFile(uintptr(m), "pty"), processTTY, nil