setcsmap Subroutine

Purpose

Reads a code-set map file and assigns it to the standard input device.

Library

Standard C Library (libc.a)

Syntax

#include <sys/termios.h>

int setcsmap (Path);
char * Path;

Description

The setcsmap subroutine reads in a code-set map file. The path parameter specifies the location of the code-set map file. The path is usually composed by forming a string with the csmap directory and the code set, as in the following example:

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

The file is processed and according to the included informations, the setcsmap subroutine changes the tty configuration. Multibyte processing may be enabled, and converter modules may be pushed onto the tty stream.

Parameter

Item Description
Path Names the code-set map file.

Return Values

If a code set-map file is successfully opened and compiled, a value of 0 is returned. If an error occurred, a value of 1 is returned and the errno global variable is set to identify the error.

Error Codes

Item Description
EINVAL Indicates an invalid value in the code set map.
EIO An I/O error occurred while the file system was being read.
ENOMEM Insufficient resources are available to satisfy the request.
EFAULT A kernel service, such as copyin, has failed.
ENOENT The named file does not exist.
EACCES The named file cannot be read.