Sous-routine setcsmap

Objectif

Lit un fichier de mappe de groupes de codes et l'affecte à l'unité d'entrée standard.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <sys/termios.h>
int setcsmap (Path);
char * Path;

Descriptif

La sous-routine setcsmap lit un fichier de mappe de groupe de codes. Le paramètre path indique l'emplacement du fichier de mappe de jeu de codes. Le chemin est généralement composé en formant une chaîne avec le répertoire csmap et le jeu de codes, comme dans l'exemple suivant:

n=sprintf(path,"%s%s",CSMAP_DIR,nl_langinfo(CODESET));

Le fichier est traité et, en fonction des informations incluses, la sous-routine setcsmap modifie la configuration de l'unité tty. Le traitement multioctet peut être activé et les modules de conversion peuvent être insérés dans le flux tty.

Paramètre

Article Descriptif
PATH Nomme le fichier de mappe de groupes de codes.

Valeurs renvoyées

Si un fichier de mappe de jeux de codes est correctement ouvert et compilé, la valeur 0 est renvoyée. Si une erreur s'est produite, la valeur 1 est renvoyée et la variable globale errno est définie pour identifier l'erreur.

Codes d'erreur

Article Descriptif
EINVAL Indique une valeur non valide dans la mappe de groupe de codes.
EIO Une erreur d'E-S s'est produite lors de la lecture du système de fichiers.
ENOMEM Les ressources disponibles sont insuffisantes pour répondre à la demande.
EFAULT Un service de noyau, tel que copyin, a échoué.
ENOENT Le fichier nommé n'existe pas.
EACCES Le fichier nommé ne peut pas être lu.