2008-09-11 14:03:46 -06:00
|
|
|
// Copyright 2009 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 os
|
|
|
|
|
|
|
|
import syscall "syscall"
|
|
|
|
|
2009-04-17 01:08:24 -06:00
|
|
|
// An Error can represent any printable error condition.
|
|
|
|
type Error interface {
|
2009-10-06 20:40:35 -06:00
|
|
|
String() string;
|
2009-04-17 01:08:24 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
// A helper type that can be embedded or wrapped to simplify satisfying
|
|
|
|
// Error.
|
|
|
|
type ErrorString string
|
2009-10-06 20:40:35 -06:00
|
|
|
|
2009-05-06 18:05:46 -06:00
|
|
|
func (e ErrorString) String() string {
|
2009-10-06 20:40:35 -06:00
|
|
|
return string(e);
|
2009-04-17 01:08:24 -06:00
|
|
|
}
|
|
|
|
|
2009-05-08 15:40:20 -06:00
|
|
|
// NewError converts s to an ErrorString, which satisfies the Error interface.
|
|
|
|
func NewError(s string) Error {
|
2009-10-06 20:40:35 -06:00
|
|
|
return ErrorString(s);
|
2009-05-08 15:40:20 -06:00
|
|
|
}
|
|
|
|
|
2009-04-17 01:36:15 -06:00
|
|
|
// Errno is the Unix error number. Names such as EINVAL are simple
|
|
|
|
// wrappers to convert the error number into an Error.
|
|
|
|
type Errno int64
|
2009-10-06 20:40:35 -06:00
|
|
|
|
2009-04-17 01:36:15 -06:00
|
|
|
func (e Errno) String() string {
|
2009-10-06 20:40:35 -06:00
|
|
|
return syscall.Errstr(int(e));
|
2009-04-17 01:36:15 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
// Commonly known Unix errors.
|
|
|
|
var (
|
2009-10-06 20:40:35 -06:00
|
|
|
EPERM Error = Errno(syscall.EPERM);
|
|
|
|
ENOENT Error = Errno(syscall.ENOENT);
|
|
|
|
ESRCH Error = Errno(syscall.ESRCH);
|
|
|
|
EINTR Error = Errno(syscall.EINTR);
|
|
|
|
EIO Error = Errno(syscall.EIO);
|
|
|
|
ENXIO Error = Errno(syscall.ENXIO);
|
|
|
|
E2BIG Error = Errno(syscall.E2BIG);
|
|
|
|
ENOEXEC Error = Errno(syscall.ENOEXEC);
|
|
|
|
EBADF Error = Errno(syscall.EBADF);
|
|
|
|
ECHILD Error = Errno(syscall.ECHILD);
|
|
|
|
EDEADLK Error = Errno(syscall.EDEADLK);
|
|
|
|
ENOMEM Error = Errno(syscall.ENOMEM);
|
|
|
|
EACCES Error = Errno(syscall.EACCES);
|
|
|
|
EFAULT Error = Errno(syscall.EFAULT);
|
|
|
|
EBUSY Error = Errno(syscall.EBUSY);
|
|
|
|
EEXIST Error = Errno(syscall.EEXIST);
|
|
|
|
EXDEV Error = Errno(syscall.EXDEV);
|
|
|
|
ENODEV Error = Errno(syscall.ENODEV);
|
|
|
|
ENOTDIR Error = Errno(syscall.ENOTDIR);
|
|
|
|
EISDIR Error = Errno(syscall.EISDIR);
|
|
|
|
EINVAL Error = Errno(syscall.EINVAL);
|
|
|
|
ENFILE Error = Errno(syscall.ENFILE);
|
|
|
|
EMFILE Error = Errno(syscall.EMFILE);
|
|
|
|
ENOTTY Error = Errno(syscall.ENOTTY);
|
|
|
|
EFBIG Error = Errno(syscall.EFBIG);
|
|
|
|
ENOSPC Error = Errno(syscall.ENOSPC);
|
|
|
|
ESPIPE Error = Errno(syscall.ESPIPE);
|
|
|
|
EROFS Error = Errno(syscall.EROFS);
|
|
|
|
EMLINK Error = Errno(syscall.EMLINK);
|
|
|
|
EPIPE Error = Errno(syscall.EPIPE);
|
|
|
|
EAGAIN Error = Errno(syscall.EAGAIN);
|
|
|
|
EDOM Error = Errno(syscall.EDOM);
|
|
|
|
ERANGE Error = Errno(syscall.ERANGE);
|
|
|
|
EADDRINUSE Error = Errno(syscall.EADDRINUSE);
|
|
|
|
ECONNREFUSED Error = Errno(syscall.ECONNREFUSED);
|
|
|
|
ENAMETOOLONG Error = Errno(syscall.ENAMETOOLONG);
|
2009-04-17 01:36:15 -06:00
|
|
|
)
|
|
|
|
|
2009-06-25 21:24:55 -06:00
|
|
|
// PathError records an error and the operation and file path that caused it.
|
|
|
|
type PathError struct {
|
2009-10-06 20:40:35 -06:00
|
|
|
Op string;
|
|
|
|
Path string;
|
|
|
|
Error Error;
|
2009-06-25 21:24:55 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
func (e *PathError) String() string {
|
|
|
|
return e.Op + " " + e.Path + ": " + e.Error.String();
|
|
|
|
}
|
|
|
|
|
|
|
|
// SyscallError records an error from a specific system call.
|
|
|
|
type SyscallError struct {
|
2009-10-06 20:40:35 -06:00
|
|
|
Syscall string;
|
|
|
|
Errno Errno;
|
2009-06-25 21:24:55 -06:00
|
|
|
}
|
|
|
|
|
|
|
|
func (e *SyscallError) String() string {
|
|
|
|
return e.Syscall + ": " + e.Errno.String();
|
|
|
|
}
|
|
|
|
|
2009-08-10 23:02:51 -06:00
|
|
|
// NewSyscallError returns, as an Error, a new SyscallError
|
2009-06-25 21:24:55 -06:00
|
|
|
// with the given system call name and error number.
|
|
|
|
// As a convenience, if errno is 0, NewSyscallError returns nil.
|
2009-08-10 23:02:51 -06:00
|
|
|
func NewSyscallError(syscall string, errno int) Error {
|
2009-06-25 21:24:55 -06:00
|
|
|
if errno == 0 {
|
|
|
|
return nil;
|
|
|
|
}
|
2009-10-06 20:40:35 -06:00
|
|
|
return &SyscallError{syscall, Errno(errno)};
|
2009-06-25 21:24:55 -06:00
|
|
|
}
|