general(1grass) [debian man page]

general(1grass) 						Grass User's Manual						   general(1grass)

GRASS GIS 6.4.2 Reference Manual
       Geographic Resources Analysis Support System, commonly referred to as GRASS, is a <a href="http://en.wikipedia.org/wiki/Geographic_informa-
       tion_system">Geographic Information System (GIS) used for geospatial data management and analysis, image processing, graphics/maps  produc-
       tion, spatial modeling, and visualization. GRASS is currently used in academic and commercial settings around the world, as well as by many
       governmental agencies and environmental consulting companies.

       This reference manual details the use of modules distributed with Geographic Resources Analysis Support System (GRASS), an open source (GNU
       GPL'ed), image processing and geographic information system (GIS).  Go back to help overview
       general commands:
	    | g.access	   | Controls access to the current mapset for other users on the system.
	    | g.ask   | Prompts the user for the names of GRASS data base files.
	    |  g.copy	| Copies available data files in the user's current mapset search path and location to the appropriate element directories
       under the user's current mapset.
	    | g.dirseps    | Internal GRASS utility for converting directory separator characters.
	    | g.extension  | Tool to maintain GRASS extensions in local GRASS installation.
	    | g.filename   | Prints GRASS data base file names.
	    | g.findetc    | Searches for GRASS support files.
	    | g.findfile   | Searches for GRASS data base files and sets variables for the shell.
	    | g.gisenv	   | Outputs and modifies the user's current GRASS variable settings.
	    | g.gui   | Launches a GRASS graphical user interface (GUI) session.
	    | g.list  | Lists available GRASS data base files of the user-specified data type.
	    | g.manual	   | Display the HTML man pages of GRASS
	    | g.mapset	   | Changes current mapset.
	    | g.mapsets    | Modifies the user's current mapset search path.
	    | g.message    | Prints a message, warning, progress info, or fatal error in the GRASS way.
	    | g.mkfontcap  | Generates the font configuration file by scanning various directories for fonts
	    | g.mlist	   | Lists available GRASS data base files of the user-specified data type optionally using the search pattern.
	    | g.mremove    | Removes data base element files from the user's current mapset.
	    | g.parser	   | Provides automated parser, GUI, and help support for GRASS scipts.
	    | g.pnmcomp    | Overlays multiple PPM image files
	    | g.proj  | Converts co-ordinate system descriptions (i.e. projection information) between various formats (including GRASS format).
	    | g.region	   | Manages the boundary definitions for the geographic region.
	    | g.remove	   | Removes data base element files from the user's current mapset.
	    | g.rename	   | Renames data base element files in the user's current mapset.
	    | g.setproj    | Interactively reset the location's projection settings.
	    | g.tempfile   | Creates a temporary file and prints the file name.
	    | g.transform  | Computes a coordinate transformation based on the control points.
	    | g.version    | Displays version and copyright information.

       Full Index
       (C) 2003-2011 GRASS Development Team

GRASS 6.4.2															   general(1grass)

grass-mysql(1grass)						Grass User's Manual					       grass-mysql(1grass)

NAME

       grass-mysql - MySQL driver

       MySQL driver MySQL driver in GRASS MySQL database driver in GRASS enables GRASS to store vector attributes in MySQL server.

       Because	vector attribute tables are created automaticaly when a new vector is written and the name of the table is the same as the name of
       the vector it is good practice to create a new database for each GRASS mapset.

Creating a MySQL database
       A new database is created within MySQL:
       mysql> CREATE DATABASE mydb;
	See the MySQL manual for details.

Driver and database name
       GRASS modules require 2 parameters to connect to a database.  Those parameters are 'driver' and 'database'. For MySQL driver the  parameter
       'driver' should be set to value 'mysql'.  The parameter 'database' can be given in two formats:

		      Database name - in case of connection from localhost

		      String of comma separated list of kye=value options.  Supported options are:

			     dbname - database name

			     host - host name or IP address

			     port - server port number
       Examples of connection parameters:
	 db.connect driver=mysql database=mytest
	 db.connect driver=mysql database='dbname=mytest,host=test.grass.org'

Data types
       GRASS supports almost all MySQL data types with following limitations:

		      Binary columns (BINARY, VARBINARY, TINYBLOB, MEDIUMBLOB, BLOB, LONGBLOB) are not not supported.  If a table with binary col-
		     umn(s) is used in GRASS a warning is printed and only the supported columns are returned in query results.

		      Columns of type SET and ENUM are represented as string (VARCHAR).

		      Very large integers in columns of type BIGINT can be lost or corrupted because GRASS does not support 64	bin  integeres	on
		     most platforms.

		      GRASS does not currently distinguish types TIMESTAMP and DATETIME. Both types are in GRASS interpreted as TIMESTAMP.

Indexes
       GRASS  modules  automaticaly create index on key column of vector attributes table. The index on key column is important for performance of
       modules which update the attribute table, for example v.to.db, v.distance and v.what.rast.

Privileges
       Because MySQL does not support groups of users and because only MySQL 'root' can grant privileges to other users GRASS cannot  automaticaly
       grant select privileges on created tables to group of users.

       If  you want to give privilege to read data from your mapset to other users you have to ask your MySQL server administrator to grant select
       privilege to them on the MySQL database used for that mapset. For example, to allow  everybody to read data in from your database 'mydb':

       shell> mysql --user=root mysql
       mysql> GRANT SELECT ON mydb.* TO ''@'%';

Schemas
       Because MySQL does not support database schemas the parameter 'schema' of module db.connect should never be set to any value.  If  you  set
       that parameter for MySQL driver GRASS will try to write tables to the specified schema which will result in errors.

Groups
       MySQL does not support user groups. Any settings specified by 'group' parameter of module db.connect are ignored by GRASS for MySQL driver.

SEE ALSO

	db.connect, SQL support in GRASS GIS

Credits
       Development of the driver was sponsored by Faunalia (Italy) as part of a project for ATAC.

AUTHOR

       Radim Blazek

       Last changed: $Date: 2011-02-07 18:59:50 +0100 (Mon, 07 Feb 2011) $
       Help Index

GRASS 6.4.2														       grass-mysql(1grass)