listing for I
imc_init - Initializes and configures the Memory Channel Application
Programming Interface (API) library on the current host
/usr/sbin/imc_init [-a maxalloc] [-r maxrecv]
Specifies, in megabytes, the total amount of Memory Channel
address space to be made available to the Memory Channel API
library. The default amount of address space is 10 MB. This is a
Specifies, in megabytes, the maximum amount of Memory Channel
address space that can be attached for receive on the host. The
default amount of receive space is 10 MB. This limit applies only
to the current host.
The imc_init command initializes and configures the MEMORY CHANNEL API
library on the current host. Initializing the Memory Channel API library
occurs either by automatic execution of the imc_init command at system boot
time, or by the system administrator invoking the command from the command
line after the system boots.
Initializing the Memory Channel API library at system boot time is
controlled by the IMC_AUTO_INIT variable in the /etc/rc.config file. If
the value of this variable is set to 1, the imc_init command is invoked at
system boot time. When the Memory Channel API library is initialized at
boot time, the values of the -a maxalloc and -a maxrecv flags are set to
the values specified by the IMC_MAX_ALLOC and IMC_MAX_RECV variables
respectively in the /etc/rc.config file.
If the IMC_AUTO_INIT variable is set to 0, the Memory Channel API library
is not initialized at system boot time. The system administrator must
invoke the imc_init command to initialize the API. The parameter values in
the /etc/rc.config file are not used when the imc_init command is manually
The imc_init command initializes the Memory Channel API library the first
time it is invoked, whether this happens during system boot time or after
the system has booted. The value of the -a maxalloc flag should be the same
on all hosts in the Memory Channel API cluster. If different values are
specified, the maximum value specified for any host determines the
clusterwide value that applies to all hosts.
After the Memory Channel API has initialized on the current host, the
system administrator can invoke the imc_init command again to reconfigure
the values of the maxalloc and maxrecv resource limits, without forcing a
reboot. The system administrator can increase or decrease either limit, but
the new limits cannot be lower than the current usage of the resources.
Reconfiguring the Memory Channel API cluster from the command line does not
read or modify the values specified in the /etc/rc.config file. The system
administrator can use the rcmgr command to modify the parameters and have
them take effect when the system reboots.
You must have root privileges to execute the imc_init command.
The imc_init command prints the following error messages:
· Receive area is bigger than the maximum allocation
The receive size is larger than the maximum allocation size.
· No Memory Channel memory available
There is not enough Memory Channel address space to initialize the
MEMORY CHANNEL API library.
· No Memory Channel resources available
There are insufficient Memory Channel data structures available to
initialize the Memory Channel API library.
· Memory Channel is not initialized for user access
This host has not been initialized to use the Memory Channel API.
Ensure that the Memory Channel cables are properly connected.
· Privileged command
You do not have root privileges. You must have root privileges to
execute the imc_init command.
· System wired memory limit cannot be exceeded. See kernel vm parameter
An attempt has been made to exceed the maximum quantity of system
wired memory. The amount of Memory Channel address space that can be
attached for receive on the host cannot be increased beyond the limit
imposed by the system parameter vm-syswiredpercent.
· Invalid parameter specification
An attempt has been made to set the maxalloc parameter or the maxrecv
parameter to zero (0), or to a non-numeric or a negative value.
Specifies the command path.
Contains the variables that control whether the Memory Channel
API library is initialized at system boot time, and specifies the
parameter values to be applied on initialization.
Commands: rcmgr(8), imcs(1)
listing for I