Como saber o que significa 'errno'?

221

Ao ligar execl(...), recebo um errno=2. O que isso significa? Como posso saber o significado disso errno?

Barth
fonte

Respostas:

339

Você pode usar strerror()para obter uma sequência legível por humanos para o número do erro. Essa é a mesma sequência impressa, perror()mas é útil se você estiver formatando a mensagem de erro para algo diferente da saída de erro padrão.

Por exemplo:

#include <errno.h>
#include <string.h>

/* ... */

if(read(fd, buf, 1)==-1) {
    printf("Oh dear, something went wrong with read()! %s\n", strerror(errno));
}

O Linux também suporta a variante explicitamente segura de threads strerror_r().

Comodoro Jaeger
fonte
5
1. Não é garantido para ser reentrante ou thread-safe 3. A maioria das implementações escreva-tampão estática interna, incluindo a implementação GNU LibC
StaceyGirl
5
@Ivan está correto e @Chris está incorreto. strerror()não é seguro para thread enquanto strerror_r()estiver seguro para thread. As funções MT-Safe ou Thread-Safe são seguras para chamar na presença de outros threads. MT, no MT-Safe, significa Multi Thread. -p26, Biblioteca GNU C char * strerror(int errnum ) [Função] Preliminar: | Corrida MT-insegura: strerror | Pilha i18n insegura | Mem-inseguro AC | Consulte a Seção 1.2.2.1 [Conceitos de segurança POSIX], página 2. -p58, A biblioteca GNU C
O @StaceyGirl glibc atualmente usa uma função para obter o endereço de errno agora, portanto errnoé seguro para threads. Olhe:#define errno *__errno_location()
SS Anne
@ JL2210 Não se trata disso errno, o GNU libc strerrorgrava no buffer global interno . Nem sempre faz isso, mas em alguns casos faz. Você substituirá esse buffer enquanto outro thread o estiver lendo.
StaceyGirl 22/03/19
Desculpe. Eu pensei que você estava falando errno, não strerror().
SS Anne
55

Em vez de executar perrorqualquer código de erro obtido, você pode recuperar uma lista completa de errnovalores em seu sistema com a seguinte linha:

cpp -dM /usr/include/errno.h | grep 'define E' | sort -n -k 3

Josh Kelley
fonte
3
Para referência, aqui está uma lista a partir do Ubuntu 14.04 amd64 pastebin.com/407gDBPq
kevinf
45

No Linux, há também uma ferramenta muito elegante que pode dizer imediatamente o que cada código de erro significa. No Ubuntu:apt-get install errno .

Então, se, por exemplo, você deseja obter a descrição do erro tipo 2, basta digitar errno 2 o terminal.

Com errno -lvocê, obtém uma lista com todos os erros e suas descrições. Muito mais fácil do que outros métodos mencionados em pôsteres anteriores.

Pithikos
fonte
+ janneb sim, no entanto, o nome do pacote errno ainda é completamente válido.
precisa
A menos que você esteja fazendo algo estranho. Normalmente, a incorporação perror/ strerroré melhor porque o USUÁRIO não precisa procurar. Embora, errno -lé melhor para encontrá-los.
jgh fun-run
29

Aqui está a saída de errno -lreformatada para facilitar a leitura:

  1   EPERM             Operation not permitted
  2   ENOENT            No such file or directory
  3   ESRCH             No such process
  4   EINTR             Interrupted system call
  5   EIO               Input/output error
  6   ENXIO             No such device or address
  7   E2BIG             Argument list too long
  8   ENOEXEC           Exec format error
  9   EBADF             Bad file descriptor
 10   ECHILD            No child processes
 11   EAGAIN            Resource temporarily unavailable
 11   EWOULDBLOCK       Resource temporarily unavailable
 12   ENOMEM            Cannot allocate memory
 13   EACCES            Permission denied
 14   EFAULT            Bad address
 15   ENOTBLK           Block device required
 16   EBUSY             Device or resource busy
 17   EEXIST            File exists
 18   EXDEV             Invalid cross-device link
 19   ENODEV            No such device
 20   ENOTDIR           Not a directory
 21   EISDIR            Is a directory
 22   EINVAL            Invalid argument
 23   ENFILE            Too many open files in system
 24   EMFILE            Too many open files
 25   ENOTTY            Inappropriate ioctl for device
 26   ETXTBSY           Text file busy
 27   EFBIG             File too large
 28   ENOSPC            No space left on device
 29   ESPIPE            Illegal seek
 30   EROFS             Read-only file system
 31   EMLINK            Too many links
 32   EPIPE             Broken pipe
 33   EDOM              Numerical argument out of domain
 34   ERANGE            Numerical result out of range
 35   EDEADLK           Resource deadlock avoided
 35   EDEADLOCK         Resource deadlock avoided
 36   ENAMETOOLONG      File name too long
 37   ENOLCK            No locks available
 38   ENOSYS            Function not implemented
 39   ENOTEMPTY         Directory not empty
 40   ELOOP             Too many levels of symbolic links
 42   ENOMSG            No message of desired type
 43   EIDRM             Identifier removed
 44   ECHRNG            Channel number out of range
 45   EL2NSYNC          Level 2 not synchronized
 46   EL3HLT            Level 3 halted
 47   EL3RST            Level 3 reset
 48   ELNRNG            Link number out of range
 49   EUNATCH           Protocol driver not attached
 50   ENOCSI            No CSI structure available
 51   EL2HLT            Level 2 halted
 52   EBADE             Invalid exchange
 53   EBADR             Invalid request descriptor
 54   EXFULL            Exchange full
 55   ENOANO            No anode
 56   EBADRQC           Invalid request code
 57   EBADSLT           Invalid slot
 59   EBFONT            Bad font file format
 60   ENOSTR            Device not a stream
 61   ENODATA           No data available
 62   ETIME             Timer expired
 63   ENOSR             Out of streams resources
 64   ENONET            Machine is not on the network
 65   ENOPKG            Package not installed
 66   EREMOTE           Object is remote
 67   ENOLINK           Link has been severed
 68   EADV              Advertise error
 69   ESRMNT            Srmount error
 70   ECOMM             Communication error on send
 71   EPROTO            Protocol error
 72   EMULTIHOP         Multihop attempted
 73   EDOTDOT           RFS specific error
 74   EBADMSG           Bad message
 75   EOVERFLOW         Value too large for defined data type
 76   ENOTUNIQ          Name not unique on network
 77   EBADFD            File descriptor in bad state
 78   EREMCHG           Remote address changed
 79   ELIBACC           Can not access a needed shared library
 80   ELIBBAD           Accessing a corrupted shared library
 81   ELIBSCN           .lib section in a.out corrupted
 82   ELIBMAX           Attempting to link in too many shared libraries
 83   ELIBEXEC          Cannot exec a shared library directly
 84   EILSEQ            Invalid or incomplete multibyte or wide character
 85   ERESTART          Interrupted system call should be restarted
 86   ESTRPIPE          Streams pipe error
 87   EUSERS            Too many users
 88   ENOTSOCK          Socket operation on non-socket
 89   EDESTADDRREQ      Destination address required
 90   EMSGSIZE          Message too long
 91   EPROTOTYPE        Protocol wrong type for socket
 92   ENOPROTOOPT       Protocol not available
 93   EPROTONOSUPPORT   Protocol not supported
 94   ESOCKTNOSUPPORT   Socket type not supported
 95   ENOTSUP           Operation not supported
 95   EOPNOTSUPP        Operation not supported
 96   EPFNOSUPPORT      Protocol family not supported
 97   EAFNOSUPPORT      Address family not supported by protocol
 98   EADDRINUSE        Address already in use
 99   EADDRNOTAVAIL     Cannot assign requested address
100   ENETDOWN          Network is down
101   ENETUNREACH       Network is unreachable
102   ENETRESET         Network dropped connection on reset
103   ECONNABORTED      Software caused connection abort
104   ECONNRESET        Connection reset by peer
105   ENOBUFS           No buffer space available
106   EISCONN           Transport endpoint is already connected
107   ENOTCONN          Transport endpoint is not connected
108   ESHUTDOWN         Cannot send after transport endpoint shutdown
109   ETOOMANYREFS      Too many references: cannot splice
110   ETIMEDOUT         Connection timed out
111   ECONNREFUSED      Connection refused
112   EHOSTDOWN         Host is down
113   EHOSTUNREACH      No route to host
114   EALREADY          Operation already in progress
115   EINPROGRESS       Operation now in progress
116   ESTALE            Stale file handle
117   EUCLEAN           Structure needs cleaning
118   ENOTNAM           Not a XENIX named type file
119   ENAVAIL           No XENIX semaphores available
120   EISNAM            Is a named type file
121   EREMOTEIO         Remote I/O error
122   EDQUOT            Disk quota exceeded
123   ENOMEDIUM         No medium found
124   EMEDIUMTYPE       Wrong medium type
125   ECANCELED         Operation canceled
126   ENOKEY            Required key not available
127   EKEYEXPIRED       Key has expired
128   EKEYREVOKED       Key has been revoked
129   EKEYREJECTED      Key was rejected by service
130   EOWNERDEAD        Owner died
131   ENOTRECOVERABLE   State not recoverable
132   ERFKILL           Operation not possible due to RF-kill
133   EHWPOISON         Memory page has hardware error

Eu usei tabularise no Vim para alinhar as colunas:

:%Tab /^[^ ]*\zs /r1l1l1
:%Tab /^ *[^ ]* *[^ ]*\zs /l1
joeytwiddle
fonte
20

O código de erro 2 significa "Arquivo / diretório não encontrado". Em geral, você pode usar a função perror para imprimir uma sequência legível por humanos.

schnaader
fonte
8

Existem algumas funções úteis para lidar com errnos. (Só para esclarecer, elas estão embutidas no libc- estou apenas fornecendo implementações de amostra porque algumas pessoas acham a leitura do código mais clara do que a leitura em inglês.)

#include <string.h>
char *strerror(int errnum);

/* you can think of it as being implemented like this: */
static char strerror_buf[1024];
const char *sys_errlist[] = {
    [EPERM]  = "Operation not permitted",
    [ENOENT] = "No such file or directory",
    [ESRCH]  = "No such process",
    [EINTR]  = "Interrupted system call",
    [EIO]    = "I/O error",
    [ENXIO]  = "No such device or address",
    [E2BIG]  = "Argument list too long",
    /* etc. */
};
int sys_nerr = sizeof(sys_errlist) / sizeof(char *);
char *strerror(int errnum) {
    if (0 <= errnum && errnum < sys_nerr && sys_errlist[errnum])
        strcpy(strerror_buf, sys_errlist[errnum]);
    else
        sprintf(strerror_buf, "Unknown error %d", errnum);
    return strerror_buf;
}

strerrorretorna uma string descrevendo o número do erro que você passou para ele. Cuidado, isso não é seguro para threads ou interrupções; é livre reescrever a string e retornar o mesmo ponteiro na próxima chamada. Use strerror_rse precisar se preocupar com isso.

#include <stdio.h>
void perror(const char *s);

/* you can think of it as being implemented like this: */
void perror(const char *s) {
    fprintf(stderr, "%s: %s\n", s, strerror(errno));
}

perrorimprime a mensagem que você enviar, além de uma sequência que descreve a atual errno, com erro padrão.

efémero
fonte
2
some people find reading code clearer than reading Englishverdade.
Qix - MONICA FOI ERRADA EM
7

Isso é mais rápido do que procurar o código errno.h, mais curto que a maioria das soluções postadas aqui e não requer a instalação de ferramentas de terceiros:

perl -E 'say $!=shift' 2

rendimentos

No such file or directory

LCC
fonte
Whoohoo. Rápido, não depende de uma recompilação e funciona (quase) em todos os lugares, inclusive em máquinas antigas onde o errno.h não está disponível. Muito obrigado.
Adrien Clerc
O que isso faz? (Eu não sei Perl)
Jonathan Lam
1
O argumento -Etrata o seguinte código citado como um script Perl. sayestá escrevendo seus argumentos na saída padrão. $!é uma variável especial que mantém o valor de errno. Se usado no contexto da string, gera a string de erro correspondente. O script atribui o valor 2a essa variável usando o shiftcomando, que é cortar a cabeça da matriz de argumentos @ARGVe colocar essa cabeça em seu lugar. A linha de comando também poderia ter sido escrita como perl -E 'say $!=2'.
LCC
5
#include <errno.h> 
#include <stdio.h> 
#include <stdlib.h> 

int main(int i, char *c[]) { 
  if (i != 2)  
    fprintf(stderr, "Usage: perror errno\n"); 
  else { 
    errno = atoi(c[1]); 
    perror(""); 
  } 
  exit(0); 
}    

Funciona no Solaris.
cc perror.c -o perror<< use esta linha para compilá-la

Johan Snowgoose
fonte
Você não deveria estar usando perror(NULL);? Com perror("");o formato é : ERROR NAME. Com perror(NULL);a saída é apenasERROR NAME
jgh fun-run
5

Aqui está a documentação . Isso deve lhe dizer o que significa e o que fazer com eles. Você deve evitar usar o valor numérico e usar as constantes listadas também, pois o número pode mudar entre sistemas diferentes.

dsm
fonte
2
Eu odeio como a documentação unix não associa constante ao valor inteiro. Qual valor é "EIO"? Os documentos são inúteis assim.
Alguém em algum lugar
4
@ SomeoneSomewhere Esse é um recurso, não um bug. Você deve sempre usar constantes de código de erro simbólicas no seu código, não literais numéricos. Isso torna seu código muito mais legível, porque algo como EQFULL é muito mais significativo que 106. Infelizmente, a linguagem não impõe isso, então você recebe pessoas que são preguiçosas ou confusas na cabeça que escrevem 106 em vez de EQFULL. Sinta-se à vontade para enviar a essas pessoas uma boa surra de colegas.
allyourcode
3
O problema é que o perror não informa a qual equivalente de macro o erro está relacionado, ele imprime outra mensagem de erro completamente não relacionada que metade do tempo nem aparece na página do manual. Eu quero um perror () que imprima o nome MACRO para que eu possa procurar o erro sangrento na página de manual!
DarwinSurvivor
@ DarwinSurvivor Você pode estar interessado na minha errnonamebiblioteca então. Ele cuida da parte tediosa de reunir todos os nomes possíveis de errno em uma função C que pode ser usada apenas trivialmente para obter o nome da macro de errno do número. Usando isso como base, fazer sua perrorvariante deve ser rápida e fácil.
Mtraceur
3

Eu uso o seguinte script:

#!/usr/bin/python

import errno
import os
import sys

toname = dict((str(getattr(errno, x)), x) 
              for x in dir(errno) 
              if x.startswith("E"))
tocode = dict((x, getattr(errno, x)) 
              for x in dir(errno) 
              if x.startswith("E"))

for arg in sys.argv[1:]:
    if arg in tocode:
        print arg, tocode[arg], os.strerror(tocode[arg])
    elif arg in toname:
        print toname[arg], arg, os.strerror(int(arg))
    else:
        print "Unknown:", arg

fonte
3

Digite sudo apt-get install moreutilse, depois de instalado, digite errno 2. Você também pode usar errno -lpara todos os números de erro, ou ver apenas os arquivos, canalizando-a para grep, como este: errno | grep file.

cuidado agora
fonte
2

Ligar

perror("execl");

em caso de erro.

Amostra:

if(read(fd, buf, 1)==-1) {
    perror("read");
}

As páginas de manual errno(3)e perror(3)são interessantes também ...

Johannes Weiss
fonte
0

Quando você usa strace (no Linux) para executar seu binário, ele gera os retornos das chamadas do sistema e o que significa o número do erro. Às vezes, isso pode ser útil para você.

Sarel Botha
fonte
0

Eu tenho a seguinte função no meu arquivo .bashrc - ele procura o valor errno dos arquivos de cabeçalho (pode ser /usr/include/errno.h,/usr/include/linux/errno.h etc., etc.)

Funciona se os arquivos de cabeçalho estiverem instalados na máquina ;-)

Normalmente, o arquivo de cabeçalho tem um erro + a seguir vem a explicação no comentário; algo do seguinte:

./asm-generic/errno-base.h:#define EAGAIN 11 / * Tente novamente * /

function errno()
{
    local arg=$1

    if [[ "x$arg" == "x-h" ]]; then
        cat <<EOF
        Usage: errno <num>
        Prints text that describes errno error number
        EOF
    else
        pushd /usr/include
        find . -name "errno*.h" | xargs grep   "[[:space:]]${arg}[[:space:]]"
        popd
    fi
}
MichaelMoser
fonte
0

Isso significa:

Arquivo ou diretório não encontrado.

Otávio Décio
fonte