env_vars(1)	       Grass User's Manual	      env_vars(1)



GRASS  5  Environment Variables Disclaimer: there is no real need
to be concerned with most of these variables.  The  default  set-
tings will work fine for most users. They are mainly used to pre-
serve settings so that the next time  the  user  runs  GRASS,  it
knows a little bit about how you left things.


       _T_h_e  _f_o_l_l_o_w_i_n_g  _i_s _a _l_i_s_t _o_f _e_n_v_i_r_o_n_m_e_n_t _v_a_r_i_a_b_l_e_s _u_s_e_d _i_n
       _G_R_A_S_S_. _T_h_e_s_e _v_a_r_i_a_b_l_e_s _w_e_r_e _f_o_u_n_d _b_y _s_e_a_r_c_h_i_n_g _a_l_l _*_._c _*_._h
       _f_i_l_e_s  _f_o_r  _t_h_e	_w_o_r_d_s _"_s_e_t_e_n_v_" _a_n_d _"_g_e_t_e_n_v_" _i_n_d_i_v_i_d_u_a_l_l_y_.
       _N_o_t_e _t_h_a_t _s_o_m_e _o_f _t_h_e_m _a_r_e _n_o_t _y_e_t  _f_o_u_n_d  _i_n  _t_h_e  _s_o_u_r_c_e
       _c_o_d_e_.  _T_h_e_s_e  _a_r_e  _i_n_d_i_c_a_t_e_d _a_l_o_n_g _w_i_t_h _t_h_e _d_a_t_e _t_h_e_y _w_e_r_e
       _l_a_s_t _c_h_e_c_k_e_d _(_d_d_/_m_m_/_y_y_)_.

       The second part lists GRASS related files.



SSeettttiinngg eennvviirroonnmmeenntt vvaarriiaabblleess
       Setting environment variables depends on the  shell  being
       used:

	      export VARIABLE=value

       or

	      setenv VARIABLE value


       An alternate option is to use "g.gisenv" (within GRASS):



       Use:	g.gisenv set=VARIABLE=VALUE


       It  looks unusual with two equals signs, but g.gisenv does
       dual duty for getting and setting GRASS environment  vari-
       ables.	If  the  user  just specifies a variable name, it
       defaults to "get" mode. Example:


       GRASS ~> g.gisenv GRASS_GUI

       text


       To ppeerrmmaanneennttllyy predefine GRASS environment  variables  the
       user may specify the variable(s) in the .grassrc5 file.

LLiisstt ooff GGRRAASSSS eennvviirroonnmmeenntt vvaarriiaabblleess
       ANGLE

       ANOTHER_BUTTON

       [v.digit]

	 define to click conveniently for two button mouse.

	 It's  hard  to click two buttons simultaneously with two
       button mouse,

	 #ifndef ANOTHER_BUTTON

	 #	 define MIDDLEB  2

	 #	 define RIGHTB 3

	 #else

	 #	 define MIDDLEB  3

	 #	 define RIGHTB 2

	 #endif

       GRASS_BACKGROUNDCOLOR

       [PNGdriver]

	 defines the background color of the image created by the
       PNG driver

       BAUD

       CMAP_SIZE

       CODECENTER

       DARKEN

       DATABASE

       DBMSCAP

       [db.connect]

	 defines DBMI driver

       DBPATH

       DB_DATABASE

       DB_DRIVER

       DB_KEYCOL

       DB_LOCATION

       DB_PASSWORD

       DB_USER

       DEB

       DEBUG

       DIGITIZER

       [v.digit]

	 name of currently selected digitizer board

       DPG_LOCK

       DUMP

       ELEMENT_LIST

	 pathname  of  element	list file to use instead of $GIS-
       BASE/etc/element_list

       ENDPANEL

       FORCE_GRASS3_COLORS

	 define to force color table output format in  3.0,  even
       if the structure

	 contains 4.0 rules

       GRASS_FP_DOUBLE

	 define    GRASS   floating   point   type   (DCELL_TYPE,
       FCELL_TYPE)

       G3D_CACHE_SIZE_ENV_VAR

       G3D_CACHE_SIZE_MAX_ENV_VAR

       G3D_COMPRESSION_ENV_VAR_NO

       G3D_COMPRESSION_ENV_VAR_YES

       G3D_DEFAULT_WINDOW3D

       G3D_FATAL_ERROR_ENV_VAR

       G3D_FILE_DOUBLE_ENV_VAR

       G3D_FILE_FLOAT_ENV_VAR

       G3D_PRECISION_ENV_VAR

       G3D_PRECISION_ENV_VAR_MAX

       G3D_PRINT_ERROR_ENV_VAR

       G3D_RLE_ENV_VAR_NO

       G3D_RLE_ENV_VAR_YES

       G3D_TILE_DIM_X_ENV_VAR

       G3D_TILE_DIM_Y_ENV_VAR

       G3D_TILE_DIM_Z_ENV_VAR

       GDAL_HOME

       GISBASE

	 directory where GRASS lives

       GISDBASE

	 initial database

       GISRC

	 name of .grassrc5 file

       GIS_LOCK

	 lock ID to prevent parallel GRAS use,

	 process id of the start-up shell script

       GMPEG_SIZE

       GRAPH

       HEIGHT

       GRASS_ADDON_PATH

       [grass5] startup script

	 allows to specify additional paths to local  GRASS  mod-
       ules extra to standard distribution

       GRASS_GNUPLOT

       [m.svfit, s.probplt, s.sv]

	 program to use for plotting "gnuplot" data

       GRASS_GUI

	 either   "text"  or  "tcltk"  to  define  non-/graphical
       startup

       GRASS_HEIGHT

       [d.mon]

	 defines the height of GRASS monitor

       GRASS_WIDTH

       [d.mon]

	 defines the width of GRASS monitor

       GTUNE_VSUP_RAM

       GTUNE_VTOC_RAM

       HOME

	 user's home directory

       GRASS_HTMLFILE

       GRASS_HTMLMAXPOINTS

       GRASS_HTMLMINBBOX

       GRASS_HTMLMINDIST

       GRASS_HTMLTYPE

       LOCATION

	full path to location directory

       LOCATION_NAME

	initial location name

       MAPLP

       [ppm driver]

       MAPSET

	 initial mapset

       MONITOR

       [d.mon]

	 name of selected GRASS monitor

       NODUMP

       NO_DRAW

       NPIXELS

       Nviz_AutoSurfColors

       [nviz]

       ORACLE_HOME

       GRASS_PAGER

       [various modules]

       Maybe set to either "less" or "more"

       PAINT

       PAINTER

	 currently selected paint output device

       PAINT_DRIVER

       PAINT_DRIVER_SHELL

       PAINT_HEADER

       PAINT_TRACE

       GRASS_ORGANIZATION

       [various vector modules which generate new vector maps]

	 To set the owner of  the  vector  map	("Organization").
       Default is "GRASS Development Team"

       GRASS_PAN_THRESHOLD

       [v.digit]

	 auto-pan  moving  speed.  Auto panning can be set off by
       setting

	 GRASS_PAN_THRESHOLD=0

       GRASS_PERL

	 set perl with path

       PGSQL - not found in source 20/02/01

       PG_HOST

       [g.select.pg]

	 name of PostgreSQL host

       PG_DBASE

       [g.select.pg]

	 name of selected PostgreSQL database

       GRASS_PNGFILE

       [PNGdriver]

	 name of PNG output file

       PREVIEW_BACKGROUND

       PROJ_LIB

       PSPAINTER

       [ps.select]

	 naem of ps device to print to

       PWAIT

       QUALITY

       RASTERFILE

       SG3D_HEIGHT

       [sg3d]

       SG3D_SITE_CACHE

       [sg3d]

       SG3D_WIDTH

       [sg3d]

       SHORT

       GRASS_SLEEP - not found in source 20/02/01

       SPAG_THRESH

       [v.spag]

	 snap threshold value

       SPRINT_COMMAND

       SQLBASE_DIR

       SQLBASE_DRIVER_STDERR

       SQLBASE_SERVER

       STARTPANEL

       GRASS_STDERR

	 set to prevent user mail on error

       GRASS_TCLSH

       [tcltkgrass, nviz]

	 set tclsh shell name to override 'tclsh'

       TERM

	 current terminal type

       GRASS_TEXT_BROWSER - not found in source 20/02/01

       GRASS_TRANSPARENT

       [PNGdriver]

	 if "TRUE", the image created by the PNG driver will have
       a transparent background

       GRASS_TRUECOLOR

       [PNGdriver]

	 if  "TRUE",  the PNG driver generates a true-color image
       (requires GD 2.0)

       USER

       WIDTH

       GRASS_WISH

       [tcltkgrass, nviz]

	 set wish shell name to override 'wish'

       WRITE

       X3D_HEIGHT

       X3D_WIDTH

       XDRIVER_PRIVATE_CMAP

       [d.mon]

	 if set, use a private colormap

       XDRIVER_WINDOW

       [d.mon]

	 if set, should contain an X window ID; XDRIVER will  use
       this window instead of creating its own

       XGANIM_SIZE

       _XPG



       GRASS-related Files:

       $HOME/.grassrc5

       $HOME/.tcltkgrass

       GIS_ERROR_LOG

	 If this file exists, all GRASS error messages are stored
       here instead of sending a mail to the GIS user. To  gener-
       ate the file, use:

	  touch GIS_ERROR_LOG



   OOtthheerr CCoommmmaannddss
       help  home,  database,  display, drivers, general, grid3d,
       imagery, misc, models, paint, photo,  postscript,  raster,
       scripts, sites, vector

       _G_R_A_S_S _D_e_v_e_l_o_p_m_e_n_t _T_e_a_m

       _$_D_a_t_e_: _2_0_0_2_/_0_2_/_1_6 _0_7_:_2_2_:_5_6 _$



GRASS 5.0					      env_vars(1)
