Drop obsoleted patch.
[linux-flexiantxendom0-3.2.10.git] / Documentation / kdb / kdb_env.man
1 .TH ENV 1 "24 September 2000"
2 .SH NAME
3 env, set \- Environment manipulation commands
4 .SH SYNOPSIS
5 env
6 .LP
7 set \fIenvironment-variable\fP=\fIvalue\fP
8 .SH DESCRIPTION
9 The kernel debugger contains an environment which contains a series
10 of name-value pairs.  Some environment variables are known to the
11 various kernel debugger commands and have specific meaning to the
12 command; such are enumerated on the respective reference material.
13 .P
14 Arbitrary environment variables may be created and used with
15 many commands (those which require an \fIaddress-expression\fP).
16 .P
17 The
18 .B env
19 command is used to display the current environment.
20 .P
21 The
22 .B set
23 command is used to alter an existing environment variable or
24 establish a new environment variable.
25 .SH LIMITATIONS
26 There is a compile-time limit of 33 environment variables.
27 .P
28 There is a compile-time limit of 512 bytes (\fBKDB_ENVBUFSIZE\fP)
29 of heap space available for new environment variables and for
30 environment variables changed from their compile-time values.
31 .SH ENVIRONMENT
32 These commands explicitly manipulate the environment.
33 .SH SMP CONSIDERATIONS
34 None.
35 .SH USER SETTINGS
36 You can include "set" commands in kdb/kdb_cmds (see kdb.mm) to define
37 your environment variables at kernel startup.
38 .SH EXAMPLES
39 .TP 8
40 env
41 Display current environment settings.
42
43 .TP 8
44 set IDCOUNT=100
45 Set the number of lines to display for the \fBid\fP command
46 to the value \fI100\fP.