Sous-routine posix_trace_attr_setname

Editer en ligne

Objectif

Définit le nom de la trace.

Bibliothèque

Bibliothèque de trace Posix (libposixtrace.a)

Syntaxe

#include <trace.h>

int posix_trace_attr_setname(attr, tracename) 
trace_attr_t *attr;
const char *tracename;

Descriptif

La sous-routine posix_trace_attr_setname définit le nom dans l'attribut trace-name de l'objet attr avec la chaîne indiquée par le paramètre tracename . Si la longueur du nom de chaîne dépasse la valeur des caractères TRACE_NAME_MAX, le nom copié dans l'objet attr sera tronqué à un nom inférieur à la longueur des caractères TRACE_NAME_MAX (voir limits.h Fichier). La valeur par défaut est une chaîne nulle.

Si la sous-routine posix_trace_attr_setname est appelée avec un objet d'attributs non initialisé comme paramètre, le résultat n'est pas spécifié.

Paramètres

Article Descriptif
attr Indique l'objet d'attributs de trace.
nom_trace Indique où l'attribut trace-name est atteint.

Valeurs renvoyées

Une fois l'opération terminée, la sous-routine posix_trace_attr_setname renvoie la valeur zéro. Sinon, il renvoie le numéro d'erreur correspondant.

Erreurs

La sous-routine posix_trace_attr_setname échoue si le numéro d'erreur suivant est renvoyé:
Article Descriptif
EINVAL L'un des paramètres est null.

Fichiers

Le fichier trace.h et les fichiers limits.h dans Files Reference