.TH g.list
.SH NAME
\fIg.list\fR  \- Lists available GRASS data base files
of the user-specified data type to standard output.
.br
.I "(GRASS File Management Program)"
.SH SYNOPSIS
\fBg.list\fR
.br
\fBg.list help\fR
.br
\fBg.list\fR [\fB-f\fR] \fBtype\*=\fIdatatype\fR [\fBmapset\*=\fIname\fR]
.SH DESCRIPTION
\fIg.list\fR allows the user to list user-specified, available
and accessible files from \fImapsets\fR under the user's current location.
When invoked simply as \fBg.list\fR, the program prompts the user
for the type of data to be listed from all
\fImapsets\fR in the user's current mapset search path.
The user can list files from a mapset not listed in the current mapset search path
by running the program non-interactively, specifying
the (optional) flag setting and parameter values on the command line.
Program flag and parameters are described below.

.LP
\fBFlag:\fR
.IP \fB-f\fR 18
Returns a verbose file listing, that includes map titles.

.LP
\fBParameters:\fR
.IP \fBtype\*=\fIdatatype\fR 18
The type of data to be listed.
.br
Options:  (listed in bold)
.RS
.TP 14
\fBrast\fR
Raster files
.TP 14
\fBvect\fR
Binary vector files
.TP 14
\fBicon\fR
Paint icon files
.TP 14
\fBlabels\fR
Paint labels files
.TP 14
\fBsites\fR
Site list files
.TP 14
\fBregion\fR
Region definition files
.TP 14
\fBgroup\fR
Imagery group files
.RE

.IP \fBmapset\*=\fIname\fR 18
The name of a mapset to be searched for files of the specified \fItype\fR.
Any mapset name under the current location, whether or not it is listed in
the user's current mapset search path, can be specified.
.br
Default:  If unspecified, files of the specified \fItype\fR from all mapsets
in the user's current search path will be listed to standard output.
.SH NOTES
If the user requests that files from a mapset to which access has been restricted
(see \fIg.access\fR be listed, no files from this mapset will be listed.
.SH "SEE ALSO"
.I g.access,
.I g.mapsets
.SH AUTHOR
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory