mklocal

Section: User Commands (1)
Updated: 10 Feb 2005
Index Return to Main Contents

NAME

mklocal - machine local mode switcher

SYNOPSIS

mklocal --set [ room ]
mklocal --unset [ room ] [ room ]
mklocal --set_localusr [ room ]
mklocal --unset_localusr [ room ] [ room ]
mklocal --addtar {filename}.tar [ room ]
mklocal --reboot [ room ]

DESCRIPTION

mklocal is a program to set, reset and reboot a machine between a "local" user and "multi" user mode. In "local" mode when booted, the follow are true: 1) only the basic machine services are started; 2) a firewall is in place to prevent users from making network connections, except for specific hosts; 3) no remote filesystems are accessible as well as any local filesystem which a user has write access in "multi" user mode; and 4) only two local user accounts are loginable (localusr and localadm). In "multi" user mode, the machine is in normal operations and the above do not apply. You must be in the groups "jrslide" and "mklocal" for this program to work. The exception to the network isolation method of this program are the set_localusr and unset_localusr options, which grant localusr working space, but allows the machine to be connected to the network and have other users logged in.

OPTIONS

--set: This sets the machine to boot into "local" mode upon next reboot.
--unset: This sets the machine to boot into "multi-user" mode upon next reboot. This also removes the file previously added by the --addtar option.
--set_localusr: This sets the machine to enable localusr workspace in a still-networked environment.
--unset_localusr: This unsets the machine from its state of networked localusr enabled. This also removes the file previously added by the --addtar option.
--addtar: This uncompresses the {filename}.tar into the localusr home directory upon next reboot with the localusr owner and group. {filename}.tar must have mklocal group ownership inorder to allow it to be added. Only one file can be added. Adding more than one will overwrite any previous file.
--reboot: This reboots the current machine. If no users processes are running, other than your own it will immediately reboot. If users processes exist, it will reboot in 15 minutes. Running this command more than once will restart the 15 minute timer if user processes still exist. If they have been removed, it would again immediately reboot.
[ room ]: The optional argument, "room", specifies whether the desired action should be performed for all machines within the same "room" on the same subnet. This options will not work if run from a machine which is in local mode and hence has access to the network.

NOTES

The localusr and localadm accounts are not active in "multi" user mode. If a machine is rebooted for any reason while in "local" mode all newly created files by the localusr or localadm account are lost. To return to "multi" user mode from "local" user mode, login as localadm and run mklocal with the "--reset" option.

AUTHOR

Douglas Motto, <dmotto@cs.rutgers.edu>
Laboratory for Computer Science Research Computing Facility, Rutgers University.

This document was created by man2html, using the manual pages.
Time: 03:29:42 GMT, November 28, 2006