.\" Copyright (c)  2000, Amnon BARAK (amnon@cs.huji.ac.il).\" All rights reserved..\" .\"	openMosix $Id: setpe.1,v 1.3 2003/02/28 19:32:15 mosixview Exp $.\".\" Permission to use, copy and distribute this software is hereby granted.\" under the terms of version 2 or any later version of the GNU General.\" Public License, as published by the Free Software Foundation..\".\" THIS MANUAL IS PROVIDED IN ITS "AS IS" CONDITION, WITH NO WARRANTY.\" WHATSOEVER. NO LIABILITY OF ANY KIND FOR DAMAGES WHATSOEVER RESULTING.\" FROM THE USE OF THIS MANUAL WILL BE ACCEPTED..\".\".\" Adapted to openMosix by David Santo Orcero, irbis@orcero.org, http://www.orcero.org/irbis.Dd August 5, 1999.Dt SETPE 1.ds vT openMosix Reference Manual.Os openMosix.Sh NAME.Nm \&setpe.Nd openMosix node configuration.Sh SYNOPSIS.Nm \&setpe.Fl [w|W].Op Fl n Ar inet.Op Fl c.Op Fl p Ar openMosix-ID.Op Fl g Ar {0|1|2}.Op Fl f Ar {filename|-}.Nm \&setpe.Fl r.Op Fl f Ar {filename|-}.Nm \&setpe.Fl off.Sh DESCRIPTION.Nm \&setpewith the .Fl w(or.Fl W )argument configures which nodes belong to a openMosix cluster by mappingtheir IP addresses into openMosix-ID numbers (1-65535). .Nm \&setpetakes its input from the standard input or, if .Fl fis used, from the specified file (use "-" for the standard intput)..Pp.Nm \&setpe.Fl rreads the current configuration. If .Fl fis used, the output is written to the specified file (use "-" forstandard output)..Pp.Nm \&setpe.Fl offshuts down openMosix by removing the configuration..PpTo configure, a simple conversion table is given as input from either.Pa filenameor the standard-input.  Each line in the table has the following three,space-separated, fields:.Pp.Pa first-openMosix-ID \ \ \ \  hostname \ \ \ \  number-of-consecutive-nodes.spThe hostnames may be specified as either IP addresses or host-names thatappear in.Pa /etc/hosts ..PpWhen a participating node is also used as a gateway between groups ofopenMosix nodes, thus having multiple IP addresses, it could be indentifyingitself in outgoing IP packets using one of the other addresses, which maycause openMosix to fail to recognize the sender.  Table entries of the followingform are used to clear the confusion:.Pp.Pa Gateways's-openMosix-ID \ \ \ \  Alternate-IP \ \ \ \  ALIAS.spThe table may also contain empty lines or comment lines (beginning with a '#').The number of entry-lines in the table is limited to 256..PpThe node's own IP address, hence its corresponding openMosix-ID, is usuallydetermined by.Pa gethostname(3) ,unless the.Fl p.Pa openMosix-IDargument specifies otherwise (this is required in case the openMosix networkis other than the node's standard network, hence uses a different IP address).In either case, the node's own IP address must be included within the suppliedtable..PpThe.Fl cargument, causes.Nm \&setpeto only check the table's consistency, without making any actual changes..PpThe.Fl gargument specifies the maximum number of gateways interposed between thecurrent openMosix node and any other openMosix node (but no more than 2).  This has theeffect of increasing the time-out when requesting information about othernodes - however, it slows down programs such as.Pa mon(1)when too many of the configured nodes are not responding..brWhen not using the.Fl goption, the value from any previous calls is maintained (or the default of 0)..PpThe openMosix configuration may be modified at any time, butwhen openMosix is already configured and the new table would cause a changeto either the node's own openMosix-ID or IP address, openMosix would need to firstbe shutdown, bringing all processes back home.Because of this drastic side-effect, the.Fl Wargument must be specified, while using the.Fl wargument will produce an error message and not modify the configuration..Sh FILES.Bl -tag -width abcdefghijklmnopqrstuvw -compact.It Pa /etc/hostsrecognised nodes..It Pa /etc/init.d/openmosixscript from which.Pa setpeis normally called..El.Sh SEE ALSO.Xr openmosix 1 ,.Xr mon 1 ..Sh HISTORY.Pa setpeis an openMosix utility.