## `module::stat` -- status of the module manager

#### Introduction

`module::stat``()` displays information about the current status of the module manager.

#### Call(s)

`module::stat()`

#### Returns

the void object of type `DOM_NULL`.

#### Related Functions

`module::age`, `module::displace`, `module::new`, `module::max`

#### Details

- `module::stat``()` displays information about the current status of the module manager, e.g. the path of the MuPAD module directory, the current and the maximum number of modules which may reside simultaneously in the main memory, the status of module aging as well as the list of the currently loaded modules.
- A large part of the information is only interesting for administration and is not needed by normal users.

#### Example 1

The status information are displayed as follows. One can see that even if all module were unloaded, the dynamic module `stdmod` is currently loaded. This is due to the fact that it is needed to create the status information and is loaded automatically when executing the function `module::stat`.

    >> module::displace():
       module::stat()

          ============================================================
          M-Path: /usr/local/mupad/linux/modules
          ------------------------------------------------------------
          Pseudo: {}
          ------------------------------------------------------------
          Kernel: obj = 201/ 202 | unload=  YES
          ------------------------------------------------------------
          Module: loaded =     1 | max   =   16 | active =           1
          Aging :  is not active | itval =   10 | LRU    =      stdmod
          ------------------------------------------------------------
          stdmod    : age=     0 | flags = {"secure"}
          ============================================================

#### Background

- `module::stat` uses the module function `stdmod::stat` to collect the status information of the module manager.
- The maximum number of seconds that the machine code of an inactive dynamic module resides in the main memory can be limited with the function `module::age` (see above `Aging:...`).
- The maximum number modules which may reside simultaneoulsy in the main memory can be limited with the function `module::max` (see above `Module:... max = 16`).
- The entry `M-Path` specifies the MuPAD module directory which contains dynamic modules including their online documentation.
- The entry `LRU = stdmod` specifies that this dynamic module will be displaced next using the least-recently-used strategy.

Do you have questions or comments?
Copyright © SciFace Software GmbH & Co. KG 2000