Index: phpdoc/fr/functions/posix.xml diff -u phpdoc/fr/functions/posix.xml:1.1 phpdoc/fr/functions/posix.xml:1.2 --- phpdoc/fr/functions/posix.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/posix.xml Mon Nov 13 01:53:42 2000 @@ -1,756 +1,834 @@ - - Fonctions POSIX - POSIX - - - - Ce module contient une interface avec les documents au standard IEEE 1003.1 (POSIX.1), - qui ne sont pas accessibles autrement. Par exemple, POSIX.1 définit les fonctions - open(), read(), write() et close(), qui ont été traditionnellement les fonctions - de PHP3. Certains fonctionnalités spécifiques ne sont pas encore disponibles, bien - que ce module tāche de remédier à cette situation avec ses fonctions. - - - - - - - posix_kill - Envoie un signal à un process. - - - Description - - bool posix_kill - int pid - int sig - - - Envoie le signal sig au processus pid. - Retourne FALSE, si il n'a pas pu envoyer le signal, et TRUE sinon. - - - Reportez vous à la page de manuel de kill(2) de votre système POSIX, qui - contient plus de détails sur les identifiants négatifs de processus, les pid - spéciaux 0 et -1, et le signal numéro 0. - - - - - - - posix_getpid - Retourne l'identifiant du processus courant. - - - Description - - int posix_getpid - void - - - Retourne l'identifiant du processus courant. - - - - - - - posix_getppid - Retourne l'identifiant du processus parent. - - - Description - - int posix_getppid - void - - - Retourne l'identifiant du processus parent du processus courant. - - - - - - - posix_getuid - - Retourne l'ID de l'utilisateur du processus courant. - - - - Description - - int posix_getuid - void - - - Retourne l'ID numérique de l'utilisateur du processus courant. Reportez vous à - posix_getpwuid pour accéder au nom d'utilisateur. - - - - - - - posix_geteuid - - Retourne l'UID effectif de l'utilisateur du processus courant. - - - - Description - - int posix_geteuid - void - - - Retourne l'UID effectif de l'utilisateur du processus courant. - Reportez vous à posix_getpwuid pour obtenir le nom - d'utilisateur. - - - - - - - posix_getgid - - Retourne l'UID du groupe du processus courant. - - - - Description - - int posix_getgid - void - - - Retourne l'UID du groupe du processus courant. Reportez vous à - posix_getgrgid pour accéder au nom du groupe. - - - - - - - posix_getegid - - Retourne l'ID effectif du groupe du processus courant. - - - - Description - - int posix_getegid - void - - - Retourne l'ID effectif du groupe du processus courant. Reportez vous à - posix_getgrgid pour transformer cette information en nom - de groupe. - - - - - - - posix_setuid - - Fixe l'UID effective du processus courant. - - - - Description - - bool posix_setuid - int uid - - - Fixe l'UID effective de l'utilisateur du processus courant. Vous devez - avoir les privilèges nécessaires (traditionnellement ceux du root) sur votre - système pour faire ceci. - - - Retourne TRUE en cas de succès, FALSE sinon. - Voir aussi posix_setgid. - - - - - - - posix_setgid - - Fixe le GID effective du processus courant. - - - - Description - - bool posix_setgid - int gid - - - Fixe le GID effective du processus courant. - Reportez vous à posix_getgrgid pour transformer cette - information en nom de groupe. L'ordre approprié est d'abord - posix_setgid, puis posix_setuid. - - - Retourne TRUE en cas de succès, FALSE sinon. - - - - - - - posix_getgroups - - Retourne les identifiants du groupe du processus courant. - - - - Description - - array posix_getgroups - void - - - Retourne un tableau contenant les identifiants du groupe du processus courant. - Reportez vous à posix_getgrgid pour pouvoir utiliser - ces id. - - - - - - - posix_getlogin - Retourne le nom de login. - - - Description - - string posix_getlogin - void - - - Retourne le nom de login de l'utilisateur qui possède le processus courant. - Reportez vous à posix_getpwnam pour obtenir plus d'information - sur cet utilisateur. - - - - - - - posix_getpgrp - - Retourne l'identifiant du groupe de processus. - - - - Description - - int posix_getpgrp - void - - - Retourne l'identifiant du groupe de processus du processus courant. - Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel de votre système POSIX - pour plus d'informations sur les groupes de processus. - - - - - - - posix_setsid - Fait du processus courant un chef de session. - - - Description - - int posix_setsid - void - - - Fait du processus courant un chef de session. Reportez vous à POSIX.1 et - setsid(2) dans le manuel de votre système POSIX pour plus d'informations sur - le contrôle de tāche. Retourne un identifiant de session. - - - - - - - posix_setpgid - Fixe l'identifiant de group de processus. - - - Description - - int posix_setpgid - int pid - int pgid - - - Ajoute le processus pid au groupe - d'id pgid. Reportez vous à POSIX.1 et - setsid(2) dans le manuel de votre système POSIX pour plus d'informations - sur le contrôle de tāche. Retourne TRUE en cas de succès, et FALSE sinon. - - - - - - - posix_getpgid - Retourne l'id du groupe de processus. - - - Description - - int posix_getpgid - int pid - - - Retourne l'id du groupe de processus pour le processus - pid. - - Ceci n'est pas une fonction POSIX, mais elle est répandu sur les systèmes BSD - et System V. Si votre système ne supporte pas cette fonction, la fonction PHP - retournera toujours FALSE. - - - - - - - posix_getsid - Retourne le sid du processus. - - - Description - - int posix_getsid - int pid - - - Retourne le sid du processus pid. - Si pid est à 0, le sid retourné sera celui du processus - courant. - - - Ceci n'est pas une fonction POSIX, mais elle est répandu sur les systèmes BSD - et System V. Si votre système ne supporte pas cette fonction, la fonction PHP - retournera toujours FALSE. - - - - - - - posix_uname - Retourne le nom du système. - - - Description - - array posix_uname - void - - - Retourne un tableau associatif avec des informations sur le système. Les - indices du tableau sont : - - - sysname - nom du système d'exploitation (e.g. Linux) - - - nodename - nom du système (e.g. valiant) - - - release - édition du système d'exploitation (e.g. 2.2.10) - - - version - version du système d'exploitation (e.g. #4 Tue Jul 20 - 17:01:36 MEST 1999) - - - machine - architecture système (e.g. i586) - - - - Posix impose que vous n'ayez pas d'a priori sur le format des chaînes, c'est à dire - que vous ne devez pas vous attendre à avoir forcément 3 chiffres pour la version, - par exemple. - - - - - - - posix_times - Utilisation des ressources. - - - Description - - array posix_times - void - - - Retourne un tableau avec les informations sur l'utilisation du CPU. - Les indices sont : - - - ticks - nombre de ticks depuis le dernier démarrage - - - utime - temps utilisateur utilisé par le processus courant. - - - stime - temps système utilisé par le processus courant. - - - cutime - temps utilisateur utilisé par le processus courant et ses enfants. - - - cstime - temps système utilisé par le processus courant et ses enfants. - - - - - - - - posix_ctermid - Retourne le chemin du terminal. - - - Description - - string posix_ctermid - void - - - Encore à faire. - - - - - - posix_ttyname - Retourne le nom de device du terminal. - - - Description - - string posix_ttyname - int fd - - - Encore à faire. - - - - - - posix_isatty - - Determine si un pointeur de fichier est un terminal interactif - . - - - Description - - bool posix_isatty - int fd - - - Encore à faire. - - - - - - posix_getcwd - Chemin du dossier courant. - - - Description - - string posix_getcwd - void - - - Encore à faire très rapidement. - - - - - - posix_mkfifo - - Crée un fichier fifo (first in, first out) (un pipe nommé) - . - - - Description - - bool posix_getcwd - string pathname - int mode - - - Encore à faire très rapidement. - - - - - - posix_getgrnam - Retourne des informations sur un groupe. - - - Description - - array posix_getgrnam - string name - - - Encore à faire. - - - - - - posix_getgrgid - Retourne des informations sur un groupe. - - - Description - - array posix_getgrgid - int gid - - - Encore à faire. - - - - - - posix_getpwnam - Retourne des informations sur un utilisateur. - - - Description - - array posix_getpwnam - string username - - - Retourne un tableau associatif qui contient des informations à propos d'un - utilisateur, identifié par son nom, passé en paramètre - username. - - - Les éléments du tableau sont : -

- Le tableau descriptif d'un utilisateur - - - - Elément - Déscription - - - - - name - - Le nom contient le nom de l'utilisateur. Généralement, c'est un nom - court, de moins de 16 caractères, mais ce n'est pas son nom réel et complet. - Cette valeur devrait correspondre au paramètre username, - et donc, il est redondant. - - - - passwd - - Contient le mot de passe de l'utilisateur, encrypté. Souvent, dans les - systèmes utilisant les mots de passes "fantômes", un astérisque est - retourné. - - - - uid - - L'UID de l'utilisateur. - - - - gid - - L'ID du groupe de l'utilisateur. Utilisez la fonction - posix_getgrgid pour connaitre le nom du groupe, et - ses membres. - - - - gecos - - GECOS est un terme obsolète qui fait référence aux données de finger, - sur un système Honeywell. Le champs, cependant, a survécu, et son contenu - a été formalisé par POSIX. Le champs contient une liste, séparée par des - virgules, qui contient le nom complet de l'utilisateur, son téléphone - professionne, son numéro de bureau, et son numéro de téléphone personnel. - Sur la plus part des sytèmes, seul le nom est disponible. - - - - dir - - Cet élément contient le chemin absolu jusqu'au dossier racine de - l'utilisateur. - - - - shell - - Cet élément contient le chemin absolu jusqu'au dossier d'éxécution du - shell de l'utilisateur. - - - - -
- - - - - - - posix_getpwuid - Retourne des informations sur un utilisateur. - - - Description - - array posix_getpwuid - int uid - - - Retourne un tableau associatif contenant des informations sur un utilisateur - repéré par son UID, passé dans le paramètre uid. - - - Les éléments du tableau sont : - - Le tableau de description d'un utilisateur - - - - Elément - Description - - - - - name - - Le nom contient le nom de l'utilisateur. Généralement, c'est un nom court, de - moins de 16 caractères, mais ce n'est pas son nom réel et complet. - - - - passwd - - Contient le mot de passe de l'utilisateur, encrypté. Souvent, dans les - systèmes utilisant les mots de passes "fantômes", un astérisque est retourné. - - - - uid - - Cette valeur devrait correspondre au paramètre uid, - et donc, il est redondant. - - - - gid - - L'ID du groupe de l'utilisateur. Utilisez la fonction - posix_getgrgid pour connaître le nom du groupe, et ses - membres. - - - - gecos - - GECOS est un terme obsolète qui fait référence aux données de finger, - sur un système Honeywell. Le champs, cependant, a survécu, et son contenu - a été formalisé par POSIX. Le champs contient une liste, séparée par des - virgules, qui contient le nom complet de l'utilisateur, son téléphone - professionne, son numéro de bureau, et son numéro de téléphone personnel. - Sur la plus part des sytèmes, seul le nom est disponible. - - - - dir - - Cet élément contient le chemin absolu jusqu'au dossier racine de - l'utilisateur. - - - - shell - - Cet élément contient le chemin absolu jusqu'au dossier d'éxécution du - shell de l'utilisateur. - - - - -
-
-
-
- - - - posix_getrlimit - Retourne les limites système. - - - Description - - array posix_getrlimit - void - - - Encore à faire ASAP. - - - - - - + + Fonctions POSIX + POSIX + + + + Ce module contient une interface avec les documents au standard + IEEE 1003.1 (POSIX.1), qui ne sont pas accessibles autrement. + Par exemple, POSIX.1 définit les fonctions open(), read(), + write() et close(), qui ont été traditionnellement + les fonctions de PHP 3. Certains fonctionnalités + spécifiques ne sont pas encore disponibles, bien que ce module + tâche de remédier à cette situation avec ses fonctions. + + + + + + + posix_kill + Envoie un signal à un process. + + + Description + + + bool posix_kill + int pid + int sig + + + + posix_kill envoie le signal + sig au processus pid. + Retourne FALSE, si il n'a pas pu envoyer le signal, et TRUE sinon. + + + Reportez vous à la page de manuel de kill(2) de votre + système POSIX, qui contient plus de détails sur + les identifiants négatifs de processus, les pid + spéciaux 0 et -1, et le signal numéro 0. + + + + + + + posix_getpid + Retourne l'identifiant du processus courant. + + + Description + + + int posix_getpid + void + + + + Retourne l'identifiant du processus courant. + + + + + + + posix_getppid + Retourne l'identifiant du processus parent. + + + Description + + int posix_getppid + void + + + Retourne l'identifiant du processus parent du processus courant. + + + + + + + posix_getuid + + Retourne l'ID de l'utilisateur du processus courant. + + + + Description + + + int posix_getuid + void + + + + Retourne l'ID numérique de l'utilisateur du processus courant. + Reportez vous à posix_getpwuid pour + accéder au nom d'utilisateur. + + + + + + + posix_geteuid + + Retourne l'UID effectif de l'utilisateur du processus courant. + + + + Description + + + int posix_geteuid + void + + + + Retourne l'UID effectif de l'utilisateur du processus courant. + Reportez vous à posix_getpwuid pour + obtenir le nom d'utilisateur. + + + + + + + posix_getgid + + Retourne l'UID du groupe du processus courant. + + + + Description + + + int posix_getgid + void + + + + Retourne l'UID du groupe du processus courant. Reportez vous à + posix_getgrgid pour accéder au nom du groupe. + + + + + + + posix_getegid + + Retourne l'ID effectif du groupe du processus courant. + + + + Description + + + int posix_getegid + void + + + + Retourne l'ID effectif du groupe du processus courant. Reportez vous à + posix_getgrgid pour transformer cette information en nom + de groupe. + + + + + + + posix_setuid + + Fixe l'UID effective du processus courant. + + + + Description + + + bool posix_setuid + int uid + + + + Fixe l'UID effective de l'utilisateur du processus courant. Vous devez + avoir les privilèges nécessaires (traditionnellement ceux + du root) sur votre système pour faire ceci. + + + Retourne TRUE en cas de succès, FALSE sinon. + Voir aussi posix_setgid. + + + + + + + posix_setgid + + Fixe le GID effective du processus courant. + + + + Description + + + bool posix_setgid + int gid + + + + Fixe le GID effective du processus courant. + Reportez vous à posix_getgrgid pour transformer + cette information en nom de groupe. L'ordre approprié est d'abord + posix_setgid, puis posix_setuid. + + + Retourne TRUE en cas de succès, FALSE sinon. + + + + + + + posix_getgroups + + Retourne les identifiants du groupe du processus courant. + + + + Description + + + array posix_getgroups + void + + + + Retourne un tableau contenant les identifiants du groupe du + processus courant. Reportez vous à + posix_getgrgid pour pouvoir utiliser ces id. + + + + + + + posix_getlogin + Retourne le nom de login. + + + Description + + + string posix_getlogin + void + + + + Retourne le nom de login de l'utilisateur qui possède le processus + courant. Reportez vous à posix_getpwnam pour + obtenir plus d'informations sur cet utilisateur. + + + + + + + posix_getpgrp + + Retourne l'identifiant du groupe de processus. + + + + Description + + + int posix_getpgrp + void + + + + Retourne l'identifiant du groupe de processus du processus courant. + Reportez vous à POSIX.1 et à getpgrp(2) dans le manuel + de votre système POSIX pour plus d'informations sur les groupes + de processus. + + + + + + + posix_setsid + Fait du processus courant un chef de session. + + + Description + + + int posix_setsid + void + + + + Fait du processus courant un chef de session. Reportez vous à + POSIX.1 et setsid(2) dans le manuel de votre système POSIX + pour plus d'informations sur le contrôle de tâche. Retourne + un identifiant de session. + + + + + + + posix_setpgid + Fixe l'identifiant de group de processus. + + + Description + + + int posix_setpgid + int pid + int pgid + + + + posix_setpgid ajoute le processus + pid au groupe d'id pgid. + Reportez vous à POSIX.1 et setsid(2) dans le manuel de votre + système POSIX pour plus d'informations sur le contrôle + de tâche. Retourne TRUE en cas de succès, et FALSE sinon. + + + + + + + posix_getpgid + Retourne l'id du groupe de processus. + + + Description + + + int posix_getpgid + int pid + + + + Retourne l'id du groupe de processus pour le processus + pid. + + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + + + + + + + posix_getsid + Retourne le sid du processus. + + + Description + + + int posix_getsid + int pid + + + + Retourne le sid du processus pid. + Si pid est à 0, le sid retourné + sera celui du processus courant. + + + Ceci n'est pas une fonction POSIX, mais elle est répandu sur + les systèmes BSD et System V. Si votre système ne + supporte pas cette fonction, la fonction PHP retournera toujours FALSE. + + + + + + + posix_uname + Retourne le nom du système. + + + Description + + + array posix_uname + void + + + + Retourne un tableau associatif avec des informations sur le système. Les + indices du tableau sont : + + + sysname - nom du système d'exploitation (e.g. Linux) + + + nodename - nom du système (e.g. valiant) + + + release - édition du système d'exploitation (e.g. 2.2.10) + + + version - version du système d'exploitation (e.g. #4 Tue Jul 20 + 17:01:36 MEST 1999) + + + machine - architecture système (e.g. i586) + + + + Posix impose que vous n'ayez pas d'a priori sur le format des + chaînes, c'est à dire que vous ne devez pas vous + attendre à avoir forcément 3 chiffres pour la version, + par exemple. + + + + + + + posix_times + Utilisation des ressources. + + + Description + + + array posix_times + void + + + + Retourne un tableau avec les informations sur l'utilisation du CPU. + Les indices sont : + + + ticks - nombre de ticks depuis le dernier démarrage + + + utime - temps utilisateur utilisé par le processus courant. + + + stime - temps système utilisé par le processus courant. + + + cutime - temps utilisateur utilisé par le processus courant et + ses enfants. + + + cstime - temps système utilisé par le processus courant + et ses enfants. + + + + + + + + posix_ctermid + Retourne le chemin du terminal. + + + Description + + + string posix_ctermid + void + + + + Encore à faire. + + + + + + posix_ttyname + Retourne le nom de device du terminal. + + + Description + + + string posix_ttyname + int fd + + + + Encore à faire. + + + + + + posix_isatty + + Determine si un pointeur de fichier est un terminal interactif + . + + + Description + + + bool posix_isatty + int fd + + + + Encore à faire. + + + + + + posix_getcwd + Chemin du dossier courant. + + + Description + + + string posix_getcwd + void + + + + Encore à faire très rapidement. + + + + + + posix_mkfifo + + Crée un fichier fifo (first in, first out) (un pipe nommé) + . + + + Description + + + bool posix_getcwd + string pathname + int mode + + + + Encore à faire très rapidement. + + + + + + posix_getgrnam + Retourne des informations sur un groupe. + + + Description + + + array posix_getgrnam + string name + + + + Encore à faire. + + + + + + posix_getgrgid + Retourne des informations sur un groupe. + + + Description + + + array posix_getgrgid + int gid + + + + Encore à faire. + + + + + + posix_getpwnam + Retourne des informations sur un utilisateur. + + + Description + + + array posix_getpwnam + string username + + + + Retourne un tableau associatif qui contient des informations à + propos d'un utilisateur, identifié par son nom, passé + en paramètre username. + + + Les éléments du tableau sont : + + Le tableau descriptif d'un utilisateur + + + + Elément + Déscription + + + + + name + + Le nom contient le nom de l'utilisateur. Généralement, + c'est un nom court, de moins de 16 caractères, mais ce n'est + pas son nom réel et complet. Cette valeur devrait correspondre + au paramètre username, et donc, il est + redondant. + + + + passwd + + Contient le mot de passe de l'utilisateur, encrypté. + Souvent, dans les systèmes utilisant les mots de passe + "fantômes", un astérisque est retourné. + + + + uid + + L'UID de l'utilisateur. + + + + gid + + L'ID du groupe de l'utilisateur. Utilisez la fonction + posix_getgrgid pour connaitre le nom du groupe, + et ses membres. + + + + gecos + + GECOS est un terme obsolète qui fait référence + aux données de finger, sur un système Honeywell. Le + champs, cependant, a survécu, et son contenu a + été formalisé par POSIX. Le champs + contient une liste, séparée par des virgules, qui + contient le nom complet de l'utilisateur, son + téléphone professionnel, son numéro de + téléphone bureau, et son numéro de + téléphone personnel. Sur la plus part des + sytèmes, seul le nom est disponible. + + + + dir + + Cet élément contient le chemin absolu jusqu'au + dossier racine de l'utilisateur. + + + + shell + + Cet élément contient le chemin absolu jusqu'au + dossier d'éxécution du shell de l'utilisateur. + + + + +
+
+
+
+ + + + posix_getpwuid + Retourne des informations sur un utilisateur. + + + Description + + + array posix_getpwuid + int uid + + + + Retourne un tableau associatif contenant des informations + sur un utilisateur repéré par son UID, + passé dans le paramètre uid. + + + Les éléments du tableau sont : + + Le tableau de description d'un utilisateur + + + + Elément + Description + + + + + name + + Le nom contient le nom de l'utilisateur. Généralement, + c'est un nom court, de moins de 16 caractères, mais ce + n'est pas son nom réel et complet. + + + + passwd + + Contient le mot de passe de l'utilisateur, encrypté. Souvent, + dans les systèmes utilisant les mots de passes + "fantômes", un astérisque est retourné. + + + + uid + + Cette valeur devrait correspondre au paramètre + uid, et donc, il est redondant. + + + + gid + + L'ID du groupe de l'utilisateur. Utilisez la fonction + posix_getgrgid pour connaître + le nom du groupe, et ses membres. + + + + gecos + + GECOS est un terme obsolète qui fait + référence aux données de finger, + sur un système Honeywell. Le champs, cependant, + a survécu, et son contenu a été + formalisé par POSIX. Le champs contient une liste, + séparée par des virgules, qui contient le nom + complet de l'utilisateur, son téléphone + professionne, son numéro de bureau, et son numéro + de téléphone personnel. + Sur la plus part des sytèmes, seul le nom est disponible. + + + + dir + + Cet élément contient le chemin absolu jusqu'au + dossier racine de l'utilisateur. + + + + shell + + Cet élément contient le chemin absolu + jusqu'au dossier d'éxécution du shell + de l'utilisateur. + + + + +
+
+
+
+ + + + posix_getrlimit + Retourne les limites système. + + + Description + + + array posix_getrlimit + void + + + + Encore à faire rapidement. + + + +
+ +