.\" Copyright (c)  2000, Amnon BARAK (amnon@cs.huji.ac.il)
.\" All rights reserved.
.\"
.\"	openMosix $Id: migrate.1,v 1.2 2003/02/28 19:09:44 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.
.\"
.Dd Jan 1, 1999
.Dt MIGRATE 1
.ds vT openMosix Reference Manual
.Os openMosix
.Sh NAME
.Nm \&migrate
.Nd request migration of a particular process on openMosix
.Sh SYNOPSIS
.Nm \&migrate
.Pa pid
.Pa {openMosix_ID|home|balance}
.Sh DESCRIPTION
.Nm \&migrate
requests openMosix to migrate the process given by
.Pa pid
to either workstation number
.Pa openMosix_ID ,
back
.Pa home
to its base-workstation, or as best suits it after considering
migration to improve the load-balance.
.Pp
While the super-user may specify any process, including even remote guests,
a normal user may only specify their processes or processes of matching real
or effective user ID.
.Pp
An appropriate error message is displayed if the kernel refuses to migrate the
process.  However, the process may also end up not migrating due to conflicting
migration-requests from other sources.
.Sh SEE ALSO
.Xr mosrun 1 ,
.Xr openmosix 1 .
.Sh HISTORY
.Pa migrate
is an openMosix utility.