newsess - start a new array session
newsess [-l] [-g] [-h ASH] [-p project] [[-s] shell-args]
The newsess command starts a new array session. The user remains logged
in and the current directory is unchanged. If the change is successful,
the user will be given a new shell. The original shell, and any
processes it may have had running, will remain alive and associated with
the original array session. Thus, exiting the new shell will return the
user to the original shell and original array session.
By default, the new array session will be a global array session (see
array_sessions(5) for more information on this subject). Some systems
are capable of generating their own global array session handles
internally, while others must request a global handle from an array
services daemon. If the -l option is specified, the system will not try
to contact an array services daemon; this will result in a purely local
array session handle on systems that do not internally generate global
handles. On the other hand, the -g option will force the system to
obtain a global array session handle from an array services daemon, even
if the system could have generated a global handle internally. In this
case, newsess will fail if an array services daemon is not available.
The -g and -l options are mutually exclusive.
The -p option can be used to set the new array session's project to
project. By default, the new array session will belong to the same
project as the current array session. If the user is not the superuser,
then the user must be authorized for project in the /etc/project file.
The superuser may force a specific array session handle to be used by
specifying the -h ASH option. An error will occur if ASH is already in
use by another array session. The -g and -h options are mutually
The first unrecognized command line argument, and all remaining arguments
that follow it, will be passed to the new shell as arguments. The
newsess option -s can be used to force the rest of the command line to be
treated as shell arguments. This is useful if it is necessary to pass an
option to the shell that also happens to be a valid newsess option. When
using shells like sh(1), an argument of the form -c string executes
string via the shell and an argument of -r will give the user a
The array services daemon (arrayd(1M)) must be running on the local
machine in order to start a new global array session. It is not required
for a new local array session.
newproj(1), newarraysess(2), array_services(5), array_sessions(5).
PPPPaaaaggggeeee 2222 [ Back ]