---

Manual Reference Pages  - system_clearenv (3m_system)

---

NAME

system_clearenv(3f) - [M_system:ENVIRONMENT] clear environment by calling clearenv(3c) (LICENSE:PD)

CONTENTS

Synopsis
Description
Return Values
Examples
Author
License

SYNOPSIS

subroutine system_clearenv(ierr)

     integer,intent(out),optional :: ierr

DESCRIPTION

The clearenv() procedure clears the environment of all name-value pairs. Typically used in security-conscious applications or ones where configuration control requires ensuring specific variables are set.

RETURN VALUES

ierr	returns zero on success, and a nonzero value on failure. Optional. If not present and an error occurs the program stops.

EXAMPLES

Sample program:

     program demo_system_clearenv
     use M_system, only : system_clearenv
     implicit none
     ! environment before clearing
     call execute_command_line(’env|wc’)
     ! environment after clearing (not necessarily blank!)
     call system_clearenv()
     call execute_command_line(’env’)
     end program demo_system_clearenv

Typical output:

     89     153    7427
     PWD=/home/urbanjs/V600
     SHLVL=1

AUTHOR

John S. Urban

LICENSE

Public Domain

---

Nemo Release 3.1

system_clearenv (3m_system)

March 07, 2025

Generated by manServer 1.08 from 09a98474-34a4-4680-9138-1a56497cf46c using man macros.