Solaris Tunable Parameters Reference Manual

System V Message Queue Parameters

msgsys:msginfo_msgmni (Solaris 9 Releases)

Obsolete in the Solaris 10 release.

Description

Maximum number of message queues that can be created.

Data Type

Signed integer

Default

50

Range

0 to MAXINT

Dynamic?

No. Loaded into msgmni field of msginfo structure.

Validation

None

When to Change

When msgget(2) calls return with an error of ENOSPC or at the recommendation of a software vendor.

Commitment Level

Unstable

msgsys:msginfo_msgtql (Solaris 9 Releases)

Obsolete in the Solaris 10 release.

Description

Maximum number of messages that can be created. If a msgsnd call attempts to exceed this limit, the request is deferred until a message header is available. Or, if the request has set the IPC_NOWAIT flag, the request fails with the error EAGAIN.

Data Type

Signed integer

Default

40

Range

0 to MAXINT

Dynamic?

No. Loaded into msgtql field of msginfo structure.

Validation

None

When to Change

When msgsnd() calls block or return with error of EGAIN, or at the recommendation of a software vendor.

Commitment Level

Unstable

msgsys:msginfo_msgmnb (Solaris 9 Releases)

Obsolete in the Solaris 10 release.

Description

Maximum number of bytes that can be on any one message queue.

Data Type

Unsigned long

Default

4096

Range

0 to amount of physical memory

Units

Bytes

Dynamic?

No. Loaded into msgmnb field of msginfo structure.

Validation

None

When to Change

When msgsnd() calls block or return with an error of EGAIN, or at the recommendation of a software vendor.

Commitment Level

Unstable

msgsys:msginfo_msgssz (Solaris 9 Releases)

Removed in the Solaris 10 release.

Description

Specifies size of chunks system uses to manage space for message buffers.

Data Type

Signed integer

Default

40

Range

0 to MAXINT

Dynamic?

No. Loaded into msgtql field of msginfostructure.

Validation

The space consumed by the maximum number of data structures that would be created to support the messages and queues is compared to 25% of the available kernel memory at the time the module is loaded. If the number is too big, the message queue module refuses to load and the facility is unavailable. This computation does include the space that might be consumed by the messages. This situation occurs only when the module is first loaded.

When to Change

When the default value is not enough. Generally changed at the recommendation of software vendors.

Commitment Level

Obsolete

msgsys:msginfo_msgmap (Solaris 9 Releases)

Removed in the Solaris 10 release.

Description

Number of messages the system supports.

Data Type

Signed integer

Default

100

Range

0 to MAXINT

Dynamic?

No

Validation

The space consumed by the maximum number of data structures that would be created to support the messages and queues is compared to 25% of the available kernel memory at the time the module is loaded. If the number is too big, the message queue module refuses to load and the facility is unavailable. This computation does include the space that might be consumed by the messages. This situation occurs only when the module is first loaded.

When to Change

When the default value is not enough. Generally changed at the recommendation of software vendors.

Commitment Level

Obsolete

msgsys:msginfo_msgseg (Solaris 9 Releases)

Removed in the Solaris 10 release.

Description

Number of msginfo_msgssz segments the system uses as a pool for available message memory. Total memory available for messages is msginfo_msgseg * msginfo_msgssz.

Data Type

Signed short

Default

1024

Range

0 to 32,767

Dynamic?

No

Validation

The space consumed by the maximum number of data structures that would be created to support the messages and queues is compared to 25% of the available kernel memory at the time the module is loaded. If the number is too big, the message queue module refuses to load and the facility is unavailable. This computation does not include the space that might be consumed by the messages. This situation occurs only when the module is first loaded.

When to Change

When the default value is not enough. Generally changed at the recommendation of software vendors.

Commitment Level

Obsolete

msgsys:msginfo_msgmax (Solaris 9 Releases)

Removed in the Solaris 10 release.

Description

Maximum size of System V message.

Data Type

Unsigned long

Default

2048

Range

0 to amount of physical memory

Units

Bytes

Dynamic?

No. Loaded into msgmax field of msginfo structure.

Validation

None

When to Change

When msgsnd(2) calls return with error of EINVAL or at the recommendation of a software vendor.

Commitment Level

Unstable