File: variables.html

package info (click to toggle)
grass 6.4.4-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 104,028 kB
  • ctags: 40,409
  • sloc: ansic: 419,980; python: 63,559; tcl: 46,692; cpp: 29,791; sh: 18,564; makefile: 7,000; xml: 3,505; yacc: 561; perl: 559; lex: 480; sed: 70; objc: 7
file content (626 lines) | stat: -rw-r--r-- 20,546 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS variables and environment variables</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">


<!-- file source: lib/init/variables.html -->

<img src="grass_logo.png" alt="_\|/_ GRASS logo"><hr align=center size=6 noshade>

<!-- meta page description: GRASS variables and environment variables -->
<h2>GRASS variables and environment variables</h2>

There are two types of variables:
<ul>
<li><a href="#enviro">shell environment</a> variables,</li>
<li><a href="#gisenv">GRASS gisenv</a> variables.</li>
</ul>

There are a number of <i>shell</i> environment variable groups:
<ul>
<li><a href="#png">PNG driver</a></li>
<li><a href="#ps">PS driver (PostScript)</a></li>
<li><a href="#html">HTMLMAP driver</a></li>
<!--<li><a href="#cairo">Cairo driver</a></li>-->
<li><a href="#dirrend">variables for direct rendering</a></li>
<li><a href="#internal">variables for internal use</a></li>
</ul>

Any setting which needs to be modifiable by a GRASS program (e.g. MONITOR)
has to be a GRASS <i>gisenv</i> variable.


<h2>GRASS-related Files</h2>

GRASS maintains some settings in a number of files on the system. They are
detailed <a href="#files">below</a>.


<h2>Setting environment variables</h2>

Setting environment variables depends on the shell being used:
<br><br>
Bash:
<div class="code"><pre>
export VARIABLE=value
</pre></div>
Csh:
<div class="code"><pre>
setenv VARIABLE value
</pre></div>
Cmd.exe (Windows):
<div class="code"><pre>
set VARIABLE=value
</pre></div>

<h2>Setting environment variables permanently</h2>

<ul>
<li>
To get personal BASH shell definitions (aliases, color listing option, ...)
into GRASS, store them in:<br>
<tt>$HOME/.grass.bashrc</tt></li>
<li>
To get personal CSH shell definitions (aliases, color listing option, ...)
into GRASS, store them in:<br>
<tt>$HOME/.grass.cshrc</tt></li>
</ul>


<h2>Setting GRASS gisenv variables</h2>

Use <em><a href="g.gisenv.html">g.gisenv</a></em> within GRASS. This permanently
predefines GRASS variables in the <tt>.grassrc6</tt> file.
<br><br>
Usage:
<div class="code"><pre>
g.gisenv set="VARIABLE=VALUE"
</pre></div>

It looks unusual with two equals signs, but <em>g.gisenv</em> serves dual duty for
getting and setting GRASS variables.
<p>
If the user just specifies a variable name, it defaults to <b>get</b> mode.
For example:
<div class="code"><pre>
g.gisenv GRASS_GUI
text
</pre></div>

<a name="enviro"></a>
<h2>List of selected (GRASS related) environment variables</h2>

<blockquote>
[ To be set from the terminal shell or startup scripts ]
</blockquote>

<dl>
  
  <dt>GISBASE</dt>
  <dd>directory where GRASS lives. This is set automatically by the
    startup script.</dd>
  
  <dt>GISRC</dt>
  <dd>name of <tt>.grassrc6</tt> file. Defines the system wide value
    while in a GRASS session.</dd>
  
  <dt>GRASS_ADDON_PATH</dt>
  <dd>[grass startup script, g.extension]<br>
    specifies additional path(s) containing local and/or custom GRASS
    modules extra to the standard distribution.</dd>
  
  <dt>GRASS_ADDON_ETC</dt>
  <dd>[libgis, g.findetc]<br>
    specify paths where support files (etc/) may be found external to
    standard distribution.</dd>
  
  <dt>GRASS_BATCH_JOB</dt>
  <dd>defines the name (path) of a shell script to be processed as
  batch job.</dd>

  <dt>GIS_ERROR_LOG</dt>
  <dd>If set, GIS_ERROR_LOG should be the absolute path to the log
   file (a relative path will be interpreted relative to the process'
   cwd, not the cwd at the point the user set the variable). If not
   set, <tt>$HOME/GIS_ERROR_LOG</tt> is used instead. The file will
   only be used if it already exists.</dd>

  <dt>GRASS_ERROR_MAIL</dt>
  <dd>set to any value to send user mail on an error or warning that 
    happens while stderr is being redirected.</dd>
  
  <dt>GRASS_GNUPLOT</dt>
  <dd>[<!-- m.svfit, s.probplt, s.sv -->i.spectral]<br>
    program to use for plotting <em>gnuplot</em> data.</dd>
  
  <dt>GRASS_GUI</dt>
  <dd>either <tt>text</tt> or <tt>gui</tt> to define non-/graphical startup.
  <br>
    Can also specify the name of the GUI to use, e.g. <tt>tcltk</tt>
    (<em><a href="gis.m.html">gis.m</a></em>), <tt>oldtcltk</tt>
    (<em><a href="d.m.html">d.m</a></em>) or <tt>wxpython</tt>
    (<em><a href="wxGUI.html">wxGUI</a></em>). Also exists as a GRASS
    gisenv variable (see below). If this shell variable exists at GRASS
    startup, it will determine the GUI used. If it is not defined startup
    will default to the last GUI used.</dd>
  
  <dt>GRASS_FONT_CAP</dt>
  <dd>[g.mkfontcap, d.font, display drivers]<br>
    specifies an alternative location (to <tt>$GISBASE/etc/fontcap</tt>) for 
    the font configuration file.</dd>
  
  <dt>GRASS_HEIGHT</dt>
  <dd>[d.mon]<br>
    defines the height of GRASS monitor, see also GRASS_WIDTH.</dd>
  
  <dt>GRASS_HTML_BROWSER</dt>
  <dd>[init.sh, d.m, gis.m]<br>
    defines name of HTML browser. For most platforms this should be
    an executable in your PATH, or the full path to an executable.<br>
    Mac OS X runs applications differently from the CLI.
    Therefore, GRASS_HTML_BROWSER should be the application's signature,
    which is a domain-like name, just reversed, i.e. com.apple.Safari. To
    find an application's signature, type the following in a Terminal
    (fill in the path to the application you are interested in, for
    example: /Applications/Safari.app):<br> &nbsp; &nbsp; <code>grep -A 1
      &quot;CFBundleIdentifier&quot;</code> <i>/path/to/application.app</i><code>/Contents/Info.plist</code><br>
    &nbsp; The signature is the &lt;string&gt; following the &lt;key&gt;,
    without the bracketing &lt;string&gt; tags.</dd>

  <dt>G_INFO_FORMAT_STANDARD</dt>
  <dd>[init.sh, wxgui]<br>
    sets percentage output and message formatting style to standard formatting.</dd>

  <dt>G_INFO_FORMAT_GUI</dt>
  <dd>[init.sh, wxgui]<br>
    sets percentage output and message formatting style to GUI formatting.</dd>

  <dt>G_INFO_FORMAT_SILENT</dt>
  <dd>[init.sh, wxgui]<br>
    disables percentage output and error messages.</dd>

  <dt>G_INFO_FORMAT_PLAIN</dt>
  <dd>[init.sh, wxgui]<br>
    sets percentage output and message formatting style to ASCII output without rewinding control characters.</dd>
 
  <dt>GRASS_INT_ZLIB</dt>
  <dd>[libgis]<br>
    if the environment variable GRASS_INT_ZLIB exists, new compressed <i>integer</i> (CELL type)
    raster maps will be compressed using zlib instead of RLE
    compression. Such rasters will have a <tt>compressed</tt> value of 2 in the
    cellhd file.
  <br>
    Obviously, decompression is controlled by the
    raster's <tt>compressed</tt> value, not the environment variable.
  </dd>
  
  <dt>GRASS_MESSAGE_FORMAT</dt>
  <dd>[various modules, wxGUI]<br>
    it may be set to either
    <ul>
      <li><tt>standard</tt> - sets percentage output and message
	formatting style to standard formatting,</li>
      <li><tt>gui</tt> - sets percentage output and message formatting
	style to GUI formatting,</li>
      <li><tt>silent</tt> - disables percentage output and error
	messages,</li>
      <li><tt>plain</tt> - sets percentage output and message
	formatting style to ASCII output without rewinding control
	characters.</li>
  </ul></dd>
  
  <dt>GRASS_MOUSE_BUTTON</dt>
  <dd>[various modules]<br>
    swaps mouse buttons for two-button or left-handed mice. Its value
    has three digits 1, 2, and 3, which represent default left, middle, and right
    buttons respectively. Setting to <tt>132</tt> will swap middle and right buttons. Note
    that this variable should be set before a display driver is initialized (e.g.,
    <tt>d.mon x0</tt>).</dd>
  
  <dt>GRASS_PAGER</dt>
  <dd>[various modules]<br>
    it may be set to either <tt>less</tt>, <tt>more</tt>, or <tt>cat</tt>.</dd>
  
  <dt>GRASS_PERL</dt>
  <dd>[used during install process for generating man pages]<br>
    set Perl with path.</dd>
  
  <dt>GRASS_RND_SEED</dt>
  <dd>set random seed
    for <em><a href="r.mapcalc.html">r.mapcalc</a></em> rand()
    function.</dd>
  
  <!-- HB Sept 2005: I don't think this exists anymore:
       <p>GRASS_STDERR
	 <br>&nbsp; set to any value to prevent user mail on error
  -->

  <dt>GRASS_SKIP_MAPSET_OWNER_CHECK</dt>
  <dd>By default it is not possible to work with MAPSETs that are
    not owned by current user. Setting this variable to any non-empty value
    allows the check to be skipped.</dd>

  <dt>GRASS_SH</dt>
  <dd>[shell scripts on Windows]<br>
    path to bourne shell interpreter used to run shell scripts.</dd>
  
  <dt>GRASS_PYTHON</dt>
  <dd>[wxGUI, Python scripting]<br>
    set to override Python executable.<br>
    On Mac OS X this should be the <tt>pythonw</tt> executable for the
    wxGUI to work.</dd>
  
  <dt>GRASS_WXBUNDLED</dt>
  <dd>[wxGUI]<br>
    set to tell wxGUI that a bundled wxPython will be used.<br>
    When set, the wxGUI will not check the wxPython version, as this
    function is incompatible with a bundled wxPython.  It is up to the
    packager to make sure that a compatible wxPython version is bundled.</dd>
  
  <dt>GRASS_TCLSH</dt>
  <dd>[nviz]<br>
    set tclsh shell name to override 'tclsh'.</dd>
  
  <dt>GRASS_XTERM</dt>
  <dd>[lib/init/grass-xterm-wrapper, lib/init/grass-xterm-mac]<br>
    set to any value (e.g. rxvt, aterm, gnome-terminal, konsole) to
    substitute 'x-terminal-emulator' or 'xterm'. The Mac OS X app
    startup defaults to an internal '$GISBASE/etc/grass-xterm-mac',
    which emulates the necessary xterm functionality in
    Terminal.app.</dd>
  
  <dt>GRASS_UI_TERM</dt>
  <dd>set to any value to use the terminal based parser.</dd>

  <dt>GRASS_VERSION</dt>
  <dd>reports the current version number (used by R-stats interface etc);
    should not be changed by user.</dd>
  
  <dt>GRASS_WIDTH</dt>
  <dd>[d.mon]<br>
    defines the width of GRASS monitor, see also GRASS_HEIGHT.</dd>
  
  <dt>GRASS_WISH</dt>
  <dd>[d.m, nviz]<br>
    set wish shell name to override 'wish'.</dd>
  
  <dt>GRASS_NO_GLX_PBUFFERS</dt>
  <dd>[nviz]<br>
    set to any value to disable the use of GLX Pbuffers.</dd>
  
  <dt>GRASS_NO_GLX_PIXMAPS</dt>
  <dd>[nviz]<br>
    Set to any value to disable the use of GLX Pixmaps.</dd>

  <dt>TMPDIR, TEMP, TMP</dt>
  <dd>[Various GRASS GIS commands and wxGUI]<br>
  <!-- what about Windows %TEMP% and http://trac.osgeo.org/grass/ticket/560#comment:21 ? -->
	The default wxGUI temporary directory is chosen from a 
	platform-dependent list, but the user can control the selection of
	this directory by setting one of the TMPDIR, TEMP or TMP
	environment variables Hence the wxGUI uses $TMPDIR if it is set,
	then $TEMP, otherwise /tmp.</dd>
</dl>

<a name="png"></a>
<h3>List of selected GRASS PNG driver environment variables</h3>

<blockquote>
[ These variables control the function of the PNG driver ]
</blockquote>

See <a href="pngdriver.html">PNG driver</a> manual page for detailed
list of the variables.

<!--
    2008/03 -- variables are described in PNG driver manual
   page. The link should be enough here.

   <p>

<p>GRASS_PNGFILE
  <br>&nbsp; name of PNG output file. If it ends with ".ppm" a PPM file will be created.
  
<p>GRASS_WIDTH
  <br>&nbsp; defines the width of GRASS monitor, see also GRASS_HEIGHT
  
<p>GRASS_HEIGHT
  <br>&nbsp; defines the height of GRASS monitor, see also GRASS_WIDTH
  
<p>GRASS_BACKGROUNDCOLOR
  <br>&nbsp; defines the background color of the image created by the PNG driver
  
<p>GRASS_TRANSPARENT
  <br>&nbsp; if "TRUE", the image created by the PNG driver will have a
  transparent background
  
<p>GRASS_PNG_COMPRESSION
  <br>&nbsp; compression level of PNG files (0 = none, 1 = fastest, 9 = best)
  
<p>GRASS_TRUECOLOR
  <br>&nbsp; if "TRUE", the PNG driver generates a true-color image
  
<p>GRASS_PNG_AUTO_WRITE
  <br>&nbsp; tells the PNG driver to write the image to a file whenever a
  client disconnects, rather than waiting until you stop the monitor
  
<p>GRASS_PNG_READ
  <br>&nbsp; if "TRUE", the PNG driver will initialize the image from
  the contents of $GRASS_PNGFILE
  
<p>GRASS_PNG_MAPPED
  <br>&nbsp; if "TRUE", the PNG driver will map $GRASS_PNGFILE as its framebuffer,
     rather than using memory; this only works with BMP files
  -->

<a name="ps"></a>
<h3>List of selected GRASS PS driver environment variables</h3>

<blockquote>
[ These variables control the function of the PS driver ]
</blockquote>

See <a href="psdriver.html">PS driver</a> manual page for detailed
list of the variables.

<!--
    2008/03 -- variables are described in PS driver manual
   page. The link should be enough here.

<p>

<p>GRASS_PSFILE
<br>&nbsp; name of output file. If it ends with ".eps" an EPS file
will be created.

<p>GRASS_PAPER <br>&nbsp; sets the screen dimensions and margins to
fit a standard paper size, see also GRASS_WIDTH, GRASS_HEIGHT.

<p>GRASS_WIDTH
<br>&nbsp; defines the width of the screen, see also GRASS_HEIGHT

<p>GRASS_HEIGHT
<br>&nbsp; defines the height of the screen, see also GRASS_WIDTH

<p>GRASS_TRUECOLOR
<br>&nbsp; if "TRUE", the PS driver generates color output, otherwise
monochrome.

<p>GRASS_LANDSCAPE
<br>&nbsp; if "TRUE", the screen is rotated 90 degrees
counter-clockwise so that a "landscape" screen fits better on
"portrait" paper.

<p>GRASS_PS_HEADER
<br>&nbsp; if "FALSE", the output is appended to any existing file,
and no prolog or setup sections are generated.

<p>GRASS_PS_TRAILER
<br>&nbsp; if "FALSE", no trailer section is generated.
-->

<a name="html"></a>
<h3>List of selected HTMLMAP driver environment variables</h3>

<blockquote>
[ These variables control the function of the HTMLMAP driver ]
</blockquote>

See <a href="htmlmapdriver.html">HTMLMAP driver</a> manual page for
detailed list of the variables.

<!--
<a name="cairo"></a>
<h3>List of selected Cairo driver environment variables</h3>

<blockquote>
[ These variables control the function of the Cairo driver ]
</blockquote>

See <a href="cairodriver.html">Cairo driver</a> manual page for
detailed list of the variables.
-->
<a name="dirrend"></a>
<h3>List of selected GRASS environment variables for direct rendering</h3>
<blockquote>
[ In addition to those which are understood by the
 <a href="pngdriver.html">PNG driver</a>, the following variables
 affect direct rendering. ]
</blockquote>

<dl>

  <dt>GRASS_RENDER_IMMEDIATE</dt>
  <dd>tells the raster library to use its built-in PNG/PS driver rather
    than connecting to an external monitor process using sockets. If
    GRASS_RENDER_IMMEDIATE=TRUE is set, there is no need to run 
    <tt>d.mon&nbsp;start=PNG</tt>.</dd>
  

  <dt>GRASS_FONT</dt>
  <dd>specifies the font as either the name of a font from
    $GISBASE/etc/fontcap (or alternative fontcap file specified by GRASS_FONT_CAP),
    or alternatively the full path to a FreeType font file.</dd>
  

  <dt>GRASS_ENCODING</dt>
  <dd>the encoding to be assumed for text which is drawn using a
    freetype font; may be any encoding know to <em>iconv</em>.</dd>
</dl>

<a name="internal"></a>
<h3>List of selected internal GRASS environment variables</h3>
<blockquote>
  [ These variables are intended <b>for internal use only</b> by the GRASS
  software to facilitate communication between the GIS engine, GRASS scripts,
  and the GUI.
  
  The user should not set these in a GRASS session. They are meant to be set
  locally for specific commands. ]
</blockquote>

<dl>
  <dt>GRASS_OVERWRITE</dt>
  <dd>[all modules]<br>
    toggles map overwrite.
    <ul>
      <li>0 - maps are protected (default),</li>
      <li>1 - maps with identical names will be overwritten.</li>
    </ul>
    This variable is automatically created
    by <em><a href="g.parser.html">g.parser</a></em> so that the
    <tt>--overwrite</tt> option will
    be inherited by dependent modules as the script runs. Setting either the
    GRASS_OVERWRITE environment variable or the OVERWRITE gisenv variable detailed
    below will cause maps with identical names to be overwritten.</dd>
  
  <dt>GRASS_VERBOSE</dt>
  <dd>[all modules]<br>
    toggles verbosity level
    <ul>
      <li>0 - only errors and warnings are printed</li>
      <li>1 - progress messages are printed (percent complete)</li>
      <li>2 - all module messages are printed</li>
      <li>3 - additional verbose messages are printed</li>
    </ul>
    This variable is automatically created by <em><a href="g.parser.html">g.parser</a></em>
    so that the <tt>--verbose</tt> or <tt>--quiet</tt> flags will be inherited
    by dependent modules as the script runs.</dd>
  
  <dt>GRASS_REGION</dt>
  <dd>[libgis]<br>
    override region settings, separate parameters with a ";". Format
    is the same as in the WIND region settings file. Otherwise use is the same as
    WIND_OVERRIDE.</dd>
  
  <dt>WIND_OVERRIDE</dt>
  <dd>[libgis]<br>
    it causes programs to use the specified named region (created with
    e.g. <tt>g.region save=...</tt>) to be used as the current region, instead of
    the region from the WIND file.<br><br>
    This allows programs such as gis.m to run external commands on an
    alternate region without having to modify the WIND file then change it
    back afterwards.</dd>
</dl>

<a name="gisenv"></a>
<h2>List of selected GRASS gisenv variables</h2>

<blockquote>
  [ Use <em><a href="g.gisenv.html">g.gisenv</a></em> to get/set/unset/change them ]
</blockquote>

<dl>
  
  <dt>DEBUG</dt>
  <dd>[entire GRASS]<br>
    sets level of debug message output (0: no debug messages)
<div class="code"><pre>
g.gisenv set=DEBUG=0
</pre></div>

  <dt>WX_DEBUG</dt>
  <dd>[wxGUI]<br>
    sets level of debug message output for <em><a href="wxGUI.html">wxGUI</a></em> (0: no debug messages, 1-5 debug levels)
  

  <dt>DM_FORM_MODE</dt>
  <dd>[d.m]<br>
    sets default form mode (<tt>txt</tt> or <tt>gui</tt>)</dd>
  

  <dt>GISDBASE</dt>
  <dd>initial database</dd>

  <dt>GIS_LOCK</dt>
  <dd>lock ID to prevent parallel GRASS use,
    <br>process id of the start-up shell script</dd>
  
  <dt>GRASS_DB_ENCODING</dt>
  <dd>[d.what.vect/forms library]<br>
    encoding of query form (utf-8, ascii, iso8859-1, koi8-r)</dd>
  

  <dt>GRASS_GUI</dt>
  <dd>either <tt>text</tt> or <tt>gui</tt> to define non-/graphical startup.
  <br> Can also specify the name of the GUI to use,
    e.g. <tt>tcltk</tt>
    (<em><a href="gis.m.html">gis.m</a></em>), <tt>oldtcltk</tt>
    (<em><a href="d.m.html">d.m</a></em>) or <tt>wxpython</tt>
    (<em><a href="wxGUI.html">wxGUI</a></em>). Also exists as a shell
    environment variable. If this shell variable exists at GRASS
    startup, it will determine the GUI used. If it is not defined
    startup will default to the last GUI used.</dd>
  
  <dt>LOCATION</dt>
  <dd>full path to location directory</dd>
  
  <dt>LOCATION_NAME</dt>
  <dd>initial location name</dd>
  
  <dt>MAPSET</dt>
  <dd>initial mapset</dd>
  
  <dt>OVERWRITE</dt>
  <dd>[all modules]<br>
    toggles map overwrite.
    <ul>
      <li>0 - maps are protected (default),</li>
      <li>1 - maps with identical names will be overwritten.</li>
    </ul>
    This variable is automatically created
    by <em><a href="g.parser.html">g.parser</a></em> so that the
    <tt>--overwrite</tt> option will
    be inherited by dependent modules as the script runs. Setting either the
    GRASS_OVERWRITE environment variable or the OVERWRITE gisenv variable detailed
    below will cause maps with identical names to be overwritten.</dd>
</dl>

<a name="files"></a>
<h2>GRASS-related Files</h2>

<dl>
  <dt>$HOME/.grassrc6</dt>
  <dd>stores the GRASS gisenv variables (but not environment variables)</dd>
  

  <dt>$HOME/.grasslogin6</dt>
  <dd>stores the DBMI passwords in this hidden file.
    Only the file owner can access this file.</dd>


  <dt>$HOME/GIS_ERROR_LOG</dt>
  <dd>if this file exists then all GRASS error and warning messages are 
    logged here. Applies to current user. To generate the file, use:
    <tt>touch $HOME/GIS_ERROR_LOG</tt><br>
   See also GIS_ERROR_LOG variable.</dd>
  
</dl>

<h2>SEE ALSO</h2>

<em>
  <a href="displaydrivers.html">Display drivers</a>

  <a href="g.gisenv.html">g.gisenv</a>,
  <a href="g.parser.html">g.parser</a>
</em>

<p>
<i>Last changed: $Date: 2014-04-30 15:58:17 +0200 (Wed, 30 Apr 2014) $</i>

<hr>

<p>
<a href=index.html>Help Index</a>
<p>
&copy; 2008-2012 <a href="http://grass.osgeo.org">GRASS Development Team</a>


</body>
</html>