NAME

       g.filename  - Prints GRASS data base file names.

KEYWORDS

       general, map management

SYNOPSIS

       g.filename
       g.filename help
       g.filename element=string file=string  [mapset=string]   [--verbose]  [--quiet]

   Parameters:
       element=string
           Name of an element

       file=string
           Name of a database file

       mapset=string
           Name of a mapset (default: current)

DESCRIPTION

       g.filename  is  designed  for  Bourne  shell scripts that need to know the full file name,
       including it's path, for mapset elements,  like  raster,  vector  and  site  maps,  region
       definitions and imagery groups.

       The  list  of  element  names  to  search for is not fixed; any subdirectory of the mapset
       directory is a valid element name.

       However, the user can  find  the  list  of  standard  GRASS  element  names  in  the  file
       $GISBASE/etc/element_list.   This  is  the  file  which  g.remove/g.rename/g.copy  use  to
       determine which files need to be deleted/renamed/copied for a given entity type.

OUTPUT

       g.filename writes one line to standard output: file='full_file_pathname'

       The output is a /bin/sh command to set the variable specified by the file name to the full
       UNIX  path  name  for  the  data  base  file.   This variable may be set in the /bin/sh as
       follows:
       eval `g.filename element=name mapset=name file=name`

NOTES

       This routine generates the filename, but does not care if the file (or mapset or  element)
       exists  or not. This feature allows shell scripts to create new data base files as well as
       use existing ones.

       If the mapset  is  the  current  mapset,  g.filename  automatically  creates  the  element
       specified  if  it  doesn't already exist.  This makes it easy to add new files to the data
       base without having to worry about the existence of the required  data  base  directories.
       (This  program will not create a new mapset, however, if that specified does not currently
       exist.)

       The program exits with a 0 if everything is ok;  it exits with a non-zero value  if  there
       is an error, in which case file='full_file_pathname' is not output.

SEE ALSO

       g.ask
       g.findfile
       g.gisenv
       parser

AUTHOR

       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

       Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team