summaryrefslogtreecommitdiffstats
path: root/src/internal/testpty/pty.go
blob: f0b2a331b8d801516306c4fc499237dfd1fd2a4f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
// 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.

// Package testpty is a simple pseudo-terminal package for Unix systems,
// implemented by calling C functions via cgo.
package testpty

import (
	"errors"
	"fmt"
	"os"
)

type PtyError struct {
	FuncName    string
	ErrorString string
	Errno       error
}

func ptyError(name string, err error) *PtyError {
	return &PtyError{name, err.Error(), err}
}

func (e *PtyError) Error() string {
	return fmt.Sprintf("%s: %s", e.FuncName, e.ErrorString)
}

func (e *PtyError) Unwrap() error { return e.Errno }

var ErrNotSupported = errors.New("testpty.Open not implemented on this platform")

// Open returns a control pty and the name of the linked process tty.
//
// If Open is not implemented on this platform, it returns ErrNotSupported.
func Open() (pty *os.File, processTTY string, err error) {
	return open()
}