SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from openSUSE Tumbleweed gnustep-base-1.26.0-34.5.x86_64.rpm

GDOMAP

Section: GNUstep System Manual (8)
Updated: August 2003
Index 

NAME

gdomap - GNUstep Distributed Objects name server

 

SYNOPSIS

gdomap[-C|-H][-Ipidfile][-Lname][-Mname][-N][-Pnumber][-Rname][-Ttype][-Uname][-afile][-cfile][-d][-f][-iseconds][-jpath][-p]

 

DESCRIPTION

gdomapThe gdomap daemon is used by GNUstep programs to look up distributed objectsof processes running across the network (and between different user accountson a single machine). The daemon is NOT used for lookup where two processesbelonging to the same user are using a host-local connection. Thismanual page explains the usage of gdomap. For design and implementationinformation (and special notes for packagers), please see the HTMLdocumentation installed in $GNUSTEP_SYSTEM_DOC, under Command-line Tools.Usually the gdomap daemon is started at system boot time and binds itself toport 538. See the GNUstep Build Guide for a sample startup script.

By default gdomap probes every machine on the local network to see if thereis a copy of gdomap running on it. This is done for class-C networks andsubnets of class-C networks. If your host is on a class-B or class-A netthen the default behaviour is to treat it as a class-C net and probe onlythe 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 alarge number of hosts which will not have gdomap on them - you may want tosupply 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 theconfiguration fileso that hosts which arenot actually on your local network can still be found when your code triesto connect to a host using @"*" as the host name. NB. this functionalitydoes 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 andnetmasks for the network interface cards on your machine. On some operatingsystems, this facility is not available (or is broken), so you must tellgdomap the addresses and masks of the interfaces using the '-a' command lineoption. The file named with '-a' should contain a series of lines withspace 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 ofnetwork interfaces and masks, please send me example code so that I canimplement 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 -Land -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,-Rand-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 DESCRIPTIONfor possible configurations.

 

DIAGNOSTICS

Kill with SIGUSR1 to obtain a dump of all known peersin /tmp/gdomap.dumpgdomap -Nlists all registered names on the local host.

 

SEE ALSO

gdomap -Cgives above instructions on how to set up gdomap.gdnc(1), GNUstep(7), gpbs(1)The GNUstep Build Guideexample rc script: <http://gnustep.made-it.com/BuildGuide/index.html#GNUSTEP.SERVICES> 

HISTORY

Work on gdomapstarted in October 1996.

This manual page first appeared in gnustep-base 1.7.1 (June 2003). 

AUTHORS

gdomapwas written by Richard Frith-Macdonald <rfmAATTgnu.org>

This manual page was put together by Martin Brecher<martinAATTmb-itconsulting.com>.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
DIAGNOSTICS
SEE ALSO
HISTORY
AUTHORS

This document was created byman2html,using the manual pages.