.\" Copyright (c)  2000, Amnon BARAK (amnon@cs.huji.ac.il).\" All rights reserved..\".\"	openMosix $Id: mosctl.1,v 1.2 2003/02/28 19:17:42 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 May 16, 1999.Dt MOSCTL 1.ds vT openMosix Reference Manual.Os openMosix.Sh NAME.Nm \&mosctl.Nd openMosix system administrator's tools.Sh SYNOPSIS.Nm \&mosctl{.Pa stay|.Pa nostay|.Pa lstay|.Pa nolstay|.Pa block|.Pa noblock|.Pa quiet|.Pa "       "noquiet|.Pa nomfs|.Pa mfs|.Pa expel|.Pa bring|.Pa gettune|.Pa getyard|.Pa getdecay}.Nm \&mosctl.Pa whois[.Pa openMosix-ID|.Pa IP-address|.Pa hostname].Nm \&mosctl{.Pa getload|.Pa getspeed|.Pa status|.Pa isup|.Pa getmem|.Pa getfree|.Pa getutil}[.Pa openMosix-ID].Nm \&mosctl.Pa setyard[.Pa processor-type|.Pa number|.Pa this].Nm \&mosctl.Pa setspeed numeric-value.Nm \&mosctl.Pa setdecay interval slow fast.Sh DESCRIPTION.Nm \&Mosctlprovides a variety of openMosix system-administration and information tools..Pp.Pa stayprevents automatic migration of processes out from the current node..Pa nostayor.Pa -staycancels the effect of.Pa stay..Pp.Pa lstayprevents only local processes from migrating away automatically, but stillallows remote/guest processes to do so..Pa nolstayor.Pa -lstaycancels the effect of.Pa lstay..Pp.Pa blockprevents remote/guest processes from arriving in..Pa noblockor.Pa -blockcancels the effect of.Pa block..Pp.Pa quietstops the background activity of the node providing other nodeswith its load-information..Pa noquietor.Pa -quietcancels the effect of.Pa quiet..Pp.Pa nomfsdisables access to this node's files via the MFS file-system (if configured)..Pa mfsre-enables access to this node's files via MFS..Pp.Pa expelsends away all remote/guest processes.  It does not return until allremote/guest processes were evacuated (or until interrupted).It also acts as.Pa block,preventing new remote/guest processes from arriving..Pp.Pa bringbrings back to the node all processes that are running away from it.It does not return until all processes were brought back (or until interrupted).It also acts as.Pa lstayin preventing local processes from migrating away automatically..Pp.Pa getdecaydisplays the current decay parameters, which control the gradual decay ofold process-statistics for the use of load-balancing.Every given number of seconds, only a given portion of the statistics is kept.That portion is different for slow-decaying (the default) and for fast-decayingprocesses..sp.Pa setdecayloads a new set of decay parameters:* Interval in seconds..br* How much out of 1000 to keep for slow-decaying processes..br* How much out of 1000 to keep for fast-decaying processes.The.Pa intervalmust be within the range of 1-65535, the.Pa slowand.Pa fastparameters must be in the range of 0-1000 and the.Pa slowparameter must be greater or equal than the.Pa fastparameter..Pp.Pa gettunedisplays the overhead parameters used by the kernel to estimate the "I/O factor"in its load-balancing.  These paramters are:.Bl -tag -width sigignore -compact.It * Deputy overhead in processing a demand-page.It * Remote overhead in processing a demand-page.It * Deputy overhead in processing a system call.It * Remote overhead in processing a system call.It * Basic deputy overhead for reading data.It * Deputy overhead per 1KB read.It * Basic remote overhead for reading data.It * Remote overhead per 1KB read.It * Basic deputy overhead for writing data.It * Deputy overhead per 1KB written.It * Basic remote overhead for writing data.It * Remote overhead per 1KB written.It * Migration time of an empty process.It * Extra migration time per dirty page.ElAll integers express microseconds..Pp.Pa getyarddisplays the.Pa yardstickin use.  This is the processor-speed of the most typical openMosix node.By default, it is 10000 speed-units, representing a Pentium-III at 1GHz..Pa setyardsets the.Pa yardstickaccording to the argument, which can be either numeric (speed-units), the word"this", implying the node's own processor-speed, or the name of arecognised processor, such as:.Br386/33, 486/66, Pentium/133 (or p/133), ppro/200, pII/300 (or Pentium2/300),pIII/1000, PIV/1400..Ppthe processor names are case-insensitive and the '/' may also be replacedby '-' or '_'..Pp.Pa whoisconverts openMosix-ID numbers to current IP addresses and vice-versa (See.Pa setpe(1)).If given an integer, it assumes a openMosix-ID and displays the correspondingIP-address.  If given an IP address (a.b.c.d), it converts it to a openMosix-ID.If given a hostname that is either listed in.Pa /etc/hostsor deteceted by named(8), it finds its IP addresses and converts it to aopenMosix-ID.  Without a second argument, the local node's openMosix-ID isdisplayed..Pp.Pa getloaddisplays the load on the given.Pa openMosix-ID(or the current node if the second argument is missing).  Although theload is a rather complex function, under normal conditions, a load of 100represents one process, constantly requiring the CPU on a node with a.Pa yardstickprocessor-speed.  On faster processors, the load caused by a similar processwould be less than 100 and accordingly, on slower processors it would be morethan 100..Pp.Pa getspeeddisplays the processor speed of the given.Pa openMosix-ID(or the current node if the second argument is missing).  The speedis relative to a Pentium-III at 1GHz being 10000 units..Pp.Pa getmem(or.Pa memoryor.Pa mem)displays the logically-free and total memory on the given.Pa openMosix-ID(or the current node if the second argument is missing).  The freememory may not necessarily correspond with "vmstat(8)", as it also takes otherfactors into account..Pp.Pa getfree(or.Pa getrawmemor.Pa rawfree)displays the raw free and total memory on the given.Pa openMosix-ID(or the current node if the second argument is missing).  The freememory should correspond with "vmstat(8)"..Pp.Pa getutildisplays the processor utilizability percentage on the given.Pa openMosix-ID(or the current node if the second argument is missing).This means how much of the timeeither the node is serving some process, or there are no processeson that node waiting for swapped-pages.  Under normal operatingconditions on a single-processor node, utilizability should be 100%,dropping only when the memory is being pressured.  On SMPs, theutilizability should be 100% times the number of processors..Pp.Pa status(or.Pa stat)displays whether the given.Pa openMosix-IDnode (or the current node if the second argument is missing) isup and connected, and whether any of the following conditions described aboveis set on that node: "stay", "lstay", "block" or "quiet"..Pp.Pa isupresponds whether the node specified by.Pa openMosix-IDis running and connected or not..Pp.Pa setspeedoverrides the node's idea of its own speed.  The speed must still bedefined so that a Pentium-III at 1GHz yields 10000 units, but this optionis provided to allow for systems that always run the same (or very similar)computation-intensive application, for which the ratio of the speeds betweendifferent processors is other than with the mixed benchmark used by openMosix..Sh SEE ALSO.Xr openmosix 1 ,.Xr setpe 1 ,.Xr tune 1 ,.Xr mon 1 ,.Xr mosrun 1 ,.Xr migrate 1 ..Sh HISTORY.Pa mosctlis an openMosix utility.