1 /*!
2  * \file lib/gis/myname.c
3  *
4  * \brief GIS Library - Database name functions.
5  *
6  * (C) 2001-2009 by the GRASS Development Team
7  *
8  * This program is free software under the GNU General Public License
9  * (>=v2). Read the file COPYING that comes with GRASS for details.
10  *
11  * \author Original author CERL
12  */
13 
14 #include <string.h>
15 #include <grass/gis.h>
16 #include <grass/glocale.h>
17 
18 /*!
19  * \brief Returns location title.
20  *
21  * Returns a one line title for the database location. This title is
22  * read from the file MYNAME in the PERMANENT mapset. See also \ref
23  * Permanent_Mapset for a discussion of the PERMANENT mapset.
24  *
25  * <b>Note:</b> This name is the first line in the file
26  * $GISDBASE/$LOCATION_NAME/PERMANENT/MYNAME
27  *
28  * \return pointer to a string
29  */
30 
G_myname(void)31 char *G_myname(void)
32 {
33     char name[GNAME_MAX];
34     char path[GPATH_MAX];
35     FILE *fd;
36     int ok;
37 
38     ok = 0;
39 
40     G_file_name(path, "", "MYNAME", "PERMANENT");
41     if ((fd = fopen(path, "r"))) {
42 	ok = G_getl(name, sizeof name, fd);
43 	fclose(fd);
44     }
45     if (!ok)
46 	strcpy(name, _("This location has no description."));
47 
48     return G_store(name);
49 }
50