Comment savoir ce que signifie le «errno»?

221

Lorsque j'appelle execl(...), j'obtiens un errno=2. Qu'est-ce que ça veut dire? Comment puis-je en connaître la signification errno?

Barth
la source

Réponses:

339

Vous pouvez utiliser strerror()pour obtenir une chaîne lisible par l'homme pour le numéro d'erreur. Il s'agit de la même chaîne imprimée parperror() mais elle est utile si vous formatez le message d'erreur pour autre chose que la sortie d'erreur standard.

Par exemple:

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

/* ... */

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

Linux prend également en charge la variante explicitement threadsafe strerror_r().

Commodore Jaeger
la source
5
1. Il n'est PAS garanti d'être réentrant ou sûr pour les threads 3. La plupart des implémentations écrivent dans le tampon statique interne, y compris l'implémentation de GNU LibC
StaceyGirl
5
@Ivan est correct et @Chris est incorrect. strerror()n'est pas thread-safe tandis qu'il strerror_r()est thread-safe. Les fonctions MT-Safe ou Thread-Safe peuvent être appelées en toute sécurité en présence d'autres threads. MT, dans MT-Safe, signifie Multi Thread. -p26, La bibliothèque GNU C char * strerror(int errnum ) [Fonction] Préliminaire: | Course MT-Unsafe: strerror | Tas AS18 non sûr | AC-mem dangereux | Voir Section 1.2.2.1 [Concepts de sécurité POSIX], page 2. -p58, La bibliothèque GNU C
@StaceyGirl glibc utilise actuellement une fonction pour obtenir l'adresse de errno maintenant, donc errnoest thread-safe. Regardez:#define errno *__errno_location()
SS Anne
@ JL2210 Ce n'est pas une question errno, strerrorécrit GNU libc dans le tampon global interne . Il ne le fait pas toujours, mais dans certains cas, il le fait. Vous écraserez ce tampon pendant qu'un autre thread le lit.
StaceyGirl
Désolé. Je pensais que tu parlais errno, non strerror().
SS Anne
55

Au lieu de fonctionner perrorsur n'importe quel code d'erreur que vous obtenez, vous pouvez récupérer une liste complète des errnovaleurs sur votre système avec la ligne unique suivante:

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

Josh Kelley
la source
3
Pour référence, voici une liste d'Ubuntu 14.04 amd64 pastebin.com/407gDBPq
kevinf
45

Sous Linux, il existe également un outil très soigné qui peut dire tout de suite ce que signifie chaque code d'erreur. Sur Ubuntu: apt-get install errno.

Ensuite, si par exemple vous voulez obtenir la description du type d'erreur 2, tapez simplement errno 2dans le terminal.

Avec errno -lvous obtenez une liste avec toutes les erreurs et leurs descriptions. Beaucoup plus facile que les autres méthodes mentionnées par les affiches précédentes.

Pithikos
la source
+ janneb oui, mais le nom du paquet errno est toujours complètement valide.
prudencenow1
Sauf si vous faites quelque chose de bizarre. Normalement, l'incorporation perror/ strerrorest meilleure car alors l'UTILISATEUR n'a pas à le rechercher. Bien, errno -lc'est mieux pour les trouver.
jgh fun-run
29

Voici la sortie de errno -lreformaté pour plus de lisibilité:

  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

J'ai utilisé tabularise dans Vim pour aligner les colonnes:

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

Le code d'erreur 2 signifie "Fichier / répertoire introuvable". En général, vous pouvez utiliser la fonction perror pour imprimer une chaîne lisible par l'homme.

schnaader
la source
8

Il existe quelques fonctions utiles pour traiter de l' errnoart. (Juste pour être clair, ceux-ci sont intégrés à libc- je fournis simplement des exemples d'implémentations parce que certaines personnes trouvent la lecture du code plus claire que la lecture de l'anglais.)

#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;
}

strerrorrenvoie une chaîne décrivant le numéro d'erreur que vous lui avez transmis. Attention, ce n'est pas sûr pour les threads ou les interruptions; il est libre de réécrire la chaîne et de renvoyer le même pointeur lors de la prochaine invocation. À utiliser strerror_rsi vous devez vous en soucier.

#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 le message que vous lui donnez, plus une chaîne décrivant le courant errno, en erreur standard.

éphémère
la source
2
some people find reading code clearer than reading Englishvérité.
Qix - MONICA A ÉTÉ BRUÉE le
7

C'est plus rapide que de rechercher le code errno.h, plus court que la plupart des solutions publiées ici et cela ne nécessite pas l'installation d'outils tiers:

perl -E 'say $!=shift' 2

les rendements

No such file or directory

LCC
la source
Whoo Hoo. Rapide, ne repose pas sur une recompilation et fonctionne (presque) partout, y compris sur les anciennes machines où errno.h n'est pas disponible. Merci beaucoup.
Adrien Clerc
Qu'est-ce que cela fait? (Je ne connais pas Perl)
Jonathan Lam
1
L'argument -Etraite le code entre guillemets suivant comme un script Perl. sayécrit ses arguments sur la sortie standard. $!est une variable spéciale contenant la valeur de errno. S'il est utilisé dans un contexte de chaîne, il renvoie la chaîne d'erreur correspondante. Le script attribue la valeur 2à cette variable à l'aide de la shiftcommande, qui coupe la tête du tableau d'arguments @ARGVet place cette tête à sa place. La ligne de commande aurait également pu être écrite comme 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); 
}    

Fonctionne sur Solaris.
cc perror.c -o perror<< utilisez cette ligne pour la compiler

Johan Snowgoose
la source
Vous ne devriez pas utiliser perror(NULL);? Avec perror("");son format est : ERROR NAME. Avec perror(NULL);sa sortie est justeERROR NAME
jgh fun-run
5

Voici la documentation . Cela devrait vous dire ce que cela signifie et ce que vous devez en faire. Vous devez éviter d'utiliser la valeur numérique et utiliser également les constantes qui y sont répertoriées, car le nombre peut varier entre différents systèmes.

dsm
la source
2
Je déteste la façon dont la documentation Unix n'associe pas la constante à la valeur entière. Quelle valeur est "EIO"? Les documents sont sans valeur comme ça.
Quelqu'un quelque part le
4
@SomeoneSomewhere C'est une fonctionnalité, pas un bug. Vous devez toujours utiliser des constantes de code d'erreur symboliques dans votre code, pas des littéraux numériques. Cela rend votre code beaucoup plus lisible, car quelque chose comme EQFULL est beaucoup plus significatif que 106. Malheureusement, le langage ne l'impose pas, donc vous obtenez des gens qui sont paresseux ou qui se trompent dans la tête qui écrivent 106 au lieu d'EQFULL. N'hésitez pas à envoyer à ces gens un bon coup de pair.
allyourcode
3
Le problème est que perror ne vous dit pas à quel équivalent de macro l'erreur se rapporte, il imprime un autre message d'erreur complètement indépendant que la moitié du temps n'apparaît même pas dans la page de manuel. Je veux une perror () qui imprime le nom MACRO afin que je puisse rechercher l'erreur sanglante dans la page de manuel!
DarwinSurvivor
@DarwinSurvivor Vous pourriez alors être intéressé par ma errnonamebibliothèque . Il prend en charge la partie fastidieuse de la collecte de tous les noms d'erreur possibles dans une fonction C qui peut être utilisée de manière triviale pour obtenir le nom de la macro d'erreur à partir du numéro. En utilisant cela comme base, faire votre perrorvariante devrait être rapide et facile.
mtraceur
3

J'utilise le script suivant:

#!/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

la source
3

Tapez sudo apt-get install moreutils, puis une fois installé, tapez errno 2. Vous pouvez également utiliser errno -lpour tous les numéros d'erreur, ou seulement ceux de fichiers par elle à la tuyauterie grep, comme ceci: errno | grep file.

prudent maintenant1
la source
2

Appel

perror("execl");

en cas d'erreur.

Échantillon:

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

Les pages de manuel de errno(3)et perror(3)sont également intéressantes ...

Johannes Weiss
la source
0

Lorsque vous utilisez strace (sous Linux) pour exécuter votre binaire, il affichera les retours des appels système et la signification du numéro d'erreur. Cela peut parfois vous être utile.

Sarel Botha
la source
0

J'ai la fonction suivante dans mon fichier .bashrc - il recherche la valeur errno des fichiers d'en-tête (peut être soit /usr/include/errno.h,/usr/include/linux/errno.h etc., etc.)

Cela fonctionne si les fichiers d'en-tête sont installés sur la machine ;-)

Habituellement, le fichier d'en-tête a une erreur + vient ensuite l'explication dans le commentaire; quelque chose de ce qui suit:

./asm-generic/errno-base.h:#define EAGAIN 11 / * Réessayez * /

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
la source
0

Ça veut dire:

Fichier ou dossier non trouvé.

Otávio Décio
la source