clearenv(3)                Library Functions Manual                clearenv(3)

NOM
       clearenv - Vider l'environnement

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdlib.h>

       int clearenv(void);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       clearenv() :
           /* glibc >= 2.19 : */ _DEFAULT_SOURCE
               || /* glibc <= 2.19 : */ _SVID_SOURCE || _BSD_SOURCE

DESCRIPTION
       La fonction clearenv() efface de l'environnement toutes les paires
       << nom-valeur >> et definit la variable externe environ a NULL. Apres
       cet appel, de nouvelles variables peuvent etre ajoutees a
       l'environnement en utilisant putenv(3) et setenv(3).

VALEUR RENVOYEE
       La fonction clearenv() renvoie zero en cas de succes et une valeur non
       nulle en cas d'echec.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------+--------------------------+---------------------+
       |Interface            | Attribut                 | Valeur              |
       +---------------------+--------------------------+---------------------+
       |clearenv()           | Securite des threads     | MT-Unsafe const:env |
       +---------------------+--------------------------+---------------------+
STANDARDS
       putenv()
              POSIX.1-2008.

       clearenv()
              Aucun.

HISTORIQUE
       putenv()
              glibc 2.0.  POSIX.1-2001.

       clearenv()
              glibc 2.0.

       Diverses variantes d'UNIX (DG/UX, HP-UX, QNX, ...). POSIX.9 (liaisons
       pour FORTRAN77). POSIX.1-1996 ne definissait pas clearenv() et
       putenv(3), mais, suite a un changement d'avis, ces fonctions ont ete
       programmees pour les versions futures de ce standard
       (cf. <section> B.4.6.1). Neanmoins, POSIX.1-2001 ajoute seulement
       putenv(3) et rejette clearenv().

NOTES
       Sur les systemes ou clearenv() n'est pas disponible, l'affectation

           environ = NULL;

       rendra sans doute le meme service.

       La fonction clearenv() peut etre utile pour des applications concernees
       par la securite et qui veulent controler de facon precise
       l'environnement passe aux programmes lances avec exec(3). Elles
       devraient le faire en nettoyant l'environnement dans un premier temps
       avant d'ajouter les variables d'environnement selectionnees par la
       suite.

       Notez que l'effet principal de cleanenv() est d'ajuster la valeur du
       pointeur environ(7) ; cette fonction n'ecrase pas le contenu des
       tampons definissant l'environnement.

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

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

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                    clearenv(3)