Does this matter? I'll predeclare DebianUsers just in case
[mirror/userdir-ldap.git] / doc / ud-xearth.1.yo
1 mailto(admin@db.debian.org)
2 manpage(ud-xearth)(1)(17 Sep 1999)(userdir-ldap)()
3 manpagename(ud-xearth)(Extracts the XEarth marker database)
4
5 manpagesynopsis()
6   ud-xearth [options]
7
8 manpagedescription()
9 ud-xearth simply extracts the lat/long information from the directory and
10 formats it in a form suitable for use by XEarth or XPlanet. The program
11 takes the lat/long coords stored in the directory and converts them to a
12 decimal degrees format and then outputs a file containing the UID of the
13 user and their coordinates as well as their full email address in a comment.
14 The output is place in a file called ./markers.dat
15
16 Since lat/long information is restricted to developers only a valid login is
17 required to extract the information. 
18
19 A good way to make use of the coordinates is the following command: 
20 verb(xplanet --shade 100 --marker_ developers.coords --color white \
21 --output developers.map.jpeg --geometry 750x450)
22           
23 manpageoptions()
24 startdit()
25 dit(bf(-u))
26 Set the authentication user. This is the user who's authority is used when 
27 accessing the LDAP directory. The default is to use the current system user
28 name.
29
30 dit(bf(-a))
31 Anonomize the data. Coordinates are truncated and no names are printed. For
32 best results the output should be sorted using 'sort -n'. Otherwise the output
33 is sorted by name..
34
35 enddit()
36
37 manpagefiles()
38 itemize(
39   it() /etc/userdir-ldap/userdir-ldap.conf
40   Configuration variables to select what server and what base DN to use.
41 )
42         
43 manpageauthor()
44 userdir-ldap was written by Jason Gunthorpe <jgg@debian.org>.