gdomap(8)
NAME
gdomap - GNUstep Distributed Objects name server
SYNOPSIS
gdomap [-C|-H] [-I pidfile] [-L name] [-M name] [-N] [-P number] [-R name] [-T type] [-U name] [-a file] [-c file] [-d] [-f] [-i seconds] [-j path] [-p]
DESCRIPTION
gdomap The gdomap daemon is used by GNUstep programs to look up
distributed objects of processes running across the network (and
between different user accounts on a single machine). The daemon is
NOT used for lookup where two processes belonging to the same user are
using a host-local connection. This manual page explains the usage of
gdomap. For design and implementation information (and special notes
for packagers), please see the HTML documentation installed in
$GNUSTEP_SYSTEM_DOC, under Command-line Tools.
Usually the gdomap daemon is started at system boot time and binds
itself to port 538. See the GNUstep Build Guide for a sample startup
script.
By default gdomap probes every machine on the local network to see if
there is a copy of gdomap running on it. This is done for class-C
networks and subnets of class-C networks. If your host is on a class-B
or class-A net then the default behaviour is to treat it as a class-C
net and probe only the hosts that would be expected on a class-C
network of the same number.
If you are running on a class-A or class-B network, or if your net has
a large number of hosts which will not have gdomap on them - you may
want to supply a configuration file listing the hosts to be probed
explicitly, rather than getting gdomap to probe all hosts on the local
net.
You may also want to supply the configuration file so that hosts which
are not actually on your local network can still be found when your
code tries to connect to a host using @"*" as the host name. NB. this
functionality does not exist in OpenStep.
A configuration file consists of a list of IP addresses to be probed.
The IP addresses should be in standard 'dot' notation, one per line.
Empty lines are permitted in the configuration file. Anything on a
line after a hash ('#') is ignored. You tell gdomap about the config
file with the '-c' command line option.
gdomap uses the SIOCGIFCONF ioctl to build a list of IP addresses and
netmasks for the network interface cards on your machine. On some
operating systems, this facility is not available (or is broken), so
you must tell gdomap the addresses and masks of the interfaces using
the '-a' command line option. The file named with '-a' should contain
a series of lines with space separated pairs of addresses and masks in
'dot' notation. You must NOT include loopback interfaces in this list.
If you want to support broadcasting of probe information on a network,
you may supply the broadcast address as a third item on the line. If
your operating system has some other method of giving you a list of
network interfaces and masks, please send me example code so that I can
implement it in gdomap.
OPTIONS
-C help about configuration
-H general help
-I pid file to write pid
-L name
perform lookup for name then quit.
-M name
machine name for -L and -N
-N list all names registered on host
-P number
port number required for -R option.
-R name
register name locally then quit.
-T type
port type for -L , -R and -U options - tcp_gdo, udp_gdo,
tcp_foreign, udp_foreign.
-U name
unregister name locally then quit.
-a file
use config file for interface list.
-c file
use config file for probe.
-d extra debug logging (normally via syslog).
-f avoid fork() to make debugging easy
-i seconds
re-probe at this interval (roughly), min 60
-j path
place the process in a chroot jail at this path rather than in
/tmp
-p disable probing for other servers
FILES
Use the -c option to specify a configuration file for gdomap. See under DESCRIPTION for possible configurations.
DIAGNOSTICS
Kill with SIGUSR1 to obtain a dump of all known peers in /tmp/gdomap.dump gdomap -N lists all registered names on the local host.
SEE ALSO
gdomap -C gives above instructions on how to set up gdomap. gdnc(1), GNUstep(7), gpbs(1) The GNUstep Build Guide example rc script: <http://gnustep.made- it.com/BuildGuide/index.html#GNUSTEP.SERVICES>
HISTORY
Work on gdomap started in October 1996. This manual page first appeared in gnustep-base 1.7.1 (June 2003).
AUTHORS
gdomap was written by Richard Frith-Macdonald <rfm@gnu.org> This manual page was put together by Martin Brecher <martin@mb- itconsulting.com>.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
