jw(1) appelle les backends comme backends/html pour effectuer le travail de conversion « réel ». Le backend récupère toutes les données nécessaires via les variables d'environnements prêtes à être utilisées.

Cette documentation décrit ces variables d'environnement.

Le backend est lancé dans le répertoire où les fichiers de sortie seront créés. Il devrait retourner 0 s'il n'y a eu aucun problème, et retourner une valeur positive autrement.  

SGML_FILE_NAME

Le nom simple du fichier source.

SGML_FILE

Le nom complet et le chemin du fichier source.

SGML_JADE

Le nom de l'analyseur syntaxique (habituellement jade ou openjade).

SGML_ARGUMENTS

La chaîne d'arguments complète pour jade ou openjade.

SGML_CATALOG_FILES

La liste des fichiers catalogues nécessaires à jade ou openjade.

SGML_STYLESHEET

La feuille de style à utiliser.

SGML_BASE_DIR

Le répertoire de base du système SGML (par défaut, c'est /usr/share/sgml).

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> 12 février 2003 et révisée le 19 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 7 backend-spec ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.  

jw(1) appelle les frontends comme frontends/docbook pour récupérer les informations spécifiques à un format d'entrée donné. Le frontend sait quelle information retourner à partir du premier argument de la ligne de commande. Il récupère toutes les données nécessaires via les variables d'environnements prêtes à être utilisées.

Ce document décrit cet argument de la ligne de commande et ces variables d'environnement.

Le frontend devrait retourner 0 s'il n'y a eu aucun problème, et retourner une valeur positive autrement.  

$1

Le paramètre de la ligne de commande, spécifiant quelle information retourner. Il peut prendre les valeurs suivantes :

centralized-catalog

Le frontend doit retourner le nom du catalogue centralisé spécifique à la DTD. Les catalogues centralisés résident normalement dans /etc/sgml et fournissent l'emplacement de tous les fichiers catalogues utiles au traitement de ce type d'entrée (le catalogue pour la DTD, le catalogue pour les feuilles de style, le catalogue pour les entités, ...)

style-sheet

Le frontend doit retourner le nom du fichier de la feuille de style à utiliser pour ce type de document et avec le backend choisi.

SGML_CATALOGS_DIR

Le répertoire où se trouvent les catalogues centralisés. Normalement, c'est /etc/sgml. (Cette variable est valide seulement pendant la détermination du catalogue centralisé à utiliser).

SGML_BASE_DIR

Le répertoire de base du système SGML. Normalement, c'est /usr/share/sgml. (Cette variable est valide seulement pendant la détermination de la feuille de style à utiliser).

SGML_FILE

Le nom du fichier à convertir. (Cette variable est valide seulement pendant la détermination du catalogue centralisé à utiliser).

SGML_TYPE

Le type de backend à utiliser, que ce soit pour produire des fichiers de sortie à afficher en ligne ou bien à imprimer. Elle peut prendre les valeurs « html » ou « print ». (Cette variable est valide seulement pendant la détermination de la feuille de style à utiliser).

SGML_STYLESHEETS

Le type de feuille de style personnalisée désirée, « none » ou « default ». Si c'est « none », le frontend doit retourner le nom du fichier fourni par le système au-dessous de docbook-utils. Si c'est « default », le frontend doit retourner la feuille de style personnalisée fournie par docbook-utils. (Cette variable est valide seulement pendant la détermination de la feuille de style à utiliser).

SGML_XML

Le métalangage du fichier à convertir, « sgml » ou « xml ». (Cette variable est valide seulement pendant la détermination du catalogue centralisé à utiliser).

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> 12 février 2003 et révisée le 19 novembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 7 frontend-spec ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.  

#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/msg.h>
#include <sys/sem.h>
#include <sys/shm.h>

struct ipc_perm {
    uid_t  cuid;   /* UID du créateur     */
    gid_t  cgid;   /* GID du créateur     */
    uid_t  uid;    /* UID du propriétaire */
    gid_t  gid;    /* GID du propriétaire */
    ushort mode;   /* Autorisations r/w   */
};

Le membre mode de la structure ipc_perm définit, sur ses 9 bits de poids faibles, les permissions d'accès à la ressource, pour un processus effectuant un appel système ipc. Les permissions sont interprétées ainsi (nombres en octal) :

    0400    Lecture par le propriétaire.
    0200    Écriture par le propriétaire.

    0040    Lecture par le groupe.
    0020    Écriture par le groupe.

    0004    Lecture par les autres.
    0002    Écriture par les autres.

Les bits 0100, 0010 et 0001 (bits exécution) ne sont pas utilisés par ces appels systèmes. De plus, « écriture » a la signification « modification » pour un ensemble de sémaphores.

Le même fichier d'entête définit également les constantes symboliques suivantes :

IPC_CREAT

Créer une entrée si la clé n'existe pas.

IPC_EXCL

Échouer si la clé existe.

IPC_NOWAIT

Retourner éventuellement une erreur, mais ne pas attendre.

IPC_PRIVATE

Clé privée.

IPC_RMID

Supprimer la ressource.

IPC_SET

Positionner une option concernant la ressource.

IPC_STAT

Obtenir les options concernant la ressource.

Notez que IPC_PRIVATE est du type key_t alors que les autres constantes symboliques sont des options que l'on regroupe avec un OU binaire « | » dans une variable de type int.  

struct msqid_ds {
    struct ipc_perm msg_perm;
    msgqnum_t       msg_qnum;    /* nb messages dans la file      */
    msglen_t        msg_qbytes;  /* octets maxi dans la file      */
    pid_t           msg_lspid;   /* PID dernier appel msgsnd(2)   */
    pid_t           msg_lrpid;   /* PID dernier appel msgrcv(2)   */
    time_t          msg_stime;   /* heure dernier appel msgsnd(2) */
    time_t          msg_rtime;   /* heure dernier appel msgrcv(2) */
    time_t          msg_ctime;   /* heure dernière modification   */
};

msg_perm

est la structure ipc_perm qui indique les permissions d'accès sur la file de messages.

msg_qnum

est le nombre de messages actuellement dans la file.

msg_qbytes

Nombre maximal d'octets pour le contenu d'un message de la file.

msg_lspid

PID du processus qui a effectué le dernier appel système msgsnd(2).

msg_lrpid

PID du processus qui a effectué le dernier appel système msgrcv(2).

msg_stime

heure du dernier appel système msgsnd(2).

msg_rtime

heure du dernier appel système msgrcv(2).

msg_ctime

heure du dernier appel système qui a modifié un membre de la structure msqid_ds.

struct semid_ds {
    struct ipc_perm sem_perm;
    time_t          sem_otime;  /* heure dernière opération    */
    time_t          sem_ctime;  /* heure dernière modification */
    unsigned long   sem_nsems;  /* nb sémaphores dans le jeu   */
};

sem_perm

est la structure ipc_perm qui indique les permissions d'accès sur l'ensemble de sémaphores.

sem_otime

Heure du dernier appel système semop(2).

sem_ctime

Heure du dernier appel système semctl(2), qui a modifié un membre de la structure ci-dessus ou l'état d'un sémaphore de l'ensemble.

sem_nsems

Nombre de sémaphores dans l'ensemble. Chaque sémaphore est référencé par un nombre positif ou nul dans l'intervalle 0 à sem_nsems-1.

Un sémaphore est une structure struct sem contenant les membres suivants :

struct sem {
    int semval;     /* Valeur du sémaphore                  */
    int sempid;     /* PID dernière opération               */
};

semval

Valeur du sémaphore : entier positif ou nul.

sempid

PID du dernier processus ayant effectué une opération sur le sémaphore.

struct shmid_ds {
    struct ipc_perm shm_perm;
    size_t          shm_segsz;   /* taille segment              */
    pid_t           shm_cpid;    /* PID créateur segment        */
    pid_t           shm_lpid;    /* PID dernière opération      */
    shmatt_t        shm_nattch;  /* Nombre d'attachements       */
    time_t          shm_atime;   /* Heure dernier attachement   */
    time_t          shm_dtime;   /* Heure dernier détachement   */
    time_t          shm_ctime;   /* Heure dernière modification */
};

shm_perm

est la structure ipc_perm qui indique les permissions d'accès sur le segment de mémoire partagée.

shm_segsz

Taille en octets du segment.

shm_cpid

PID du processus ayant créé le segment.

shm_lpid

PID du processus ayant effectué le dernier appel système shmat(2) ou shmdt(2).

shm_nattch

Nombre d'attachements en cours pour ce segment.

shm_atime

Heure du dernier appel système shmat(2).

shm_dtime

Heure du dernier appel système shmdt(2).

shm_ctime

Heure du dernier appel système shmctl(2) qui a modifié la structure shmid_ds.

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 18 octobre 1996 et révisée le 8 janvier 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 7 svipc ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

DESCRIPTION

ENVIRONNEMENT

AUTEUR

VOIR AUSSI

TRADUCTION

NOM

DESCRIPTION

ENVIRONNEMENT

AUTEUR

VOIR AUSSI

TRADUCTION

NOM

SYNOPSIS

DESCRIPTION

Autorisations d'accès aux ressources.

Files de messages.

Jeux de sémaphores.

Segments de mémoire partagée.

VOIR AUSSI

TRADUCTION