1. NOM▲

clearenv - Vider l'environnement

2. SYNOPSIS ▲

 
Sélectionnez
#include <stdlib.h>
int clearenv(void);



Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

clearenv() : _SVID_SOURCE || _BSD_SOURCE

3. DESCRIPTION ▲

La fonction clearenv() efface de l'environnement toutes les paires « nom-valeur » et définit la variable externe environ à NULL.

4. VALEUR RENVOYÉE ▲

La fonction clearenv() renvoie zéro en cas de succès et une valeur non nulle en cas d'échec.

5. VERSIONS ▲

Absente de la libc4 et de la libc5. Présente dans la glibc depuis la version 2.0.

6. CONFORMITÉ ▲

Diverses variantes d'UNIX (DG/UX, HP-UX, QNX, ...). POSIX.9 (binding pour FORTRAN77). POSIX.1-1996 ne définissait pas clearenv() et putenv(3), mais, suite à un changement d'attitude, ces fonctions ont été programmées pour les versions futures de ce standard (cf. B.4.6.1). Néanmoins, POSIX.1-2001 ajouta seulement putenv(3), et refusa clearenv().

7. NOTES ▲

Cette fonction est utilisée dans les applications sensibilisées à la sécurité. Si elle n'est pas disponible, l'affectation

 
Sélectionnez
    environ = NULL;

rendra sans doute le même service.

Les pages de manuel DG/UX et Tru64 indiquent : si environ a été modifiée par autre chose que les fonctions putenv(3), getenv(3), et clearenv(), alors clearenv() renverra une erreur et l'environnement du processus sera inchangé.

8. VOIR AUSSI ▲

getenv(3), putenv(3), setenv(3), unsetenv(3), environ(7)

9. COLOPHON ▲

Cette page fait partie de la publication 3.52 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

10. TRADUCTION ▲

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Stéphan Rafin (2002), Alain Portal <http://manpagesfr.free.fr/> (2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».