Using the prctl Command

Using the `prctl` Command

Use the prctl command to make runtime interrogations of and modifications to the resource controls associated with an active process, task, or project on the system. See the prctl(1) man page for more information.

How to Use the `prctl` Command to Display Default Resource Control Values

This procedure must be used on a system on which no resource controls have been set or changed. There can be only non-default entries in the /etc/system file or in the project database.

Use the prctl command on any process, such as the current shell that is running.

# prctl $$
process: 3320: bash
NAME    PRIVILEGE       VALUE    FLAG   ACTION                       RECIPIENT
process.max-port-events
        privileged      65.5K       -   deny                                 -
        system          2.15G     max   deny                                 -
process.max-msg-messages
        privileged      8.19K       -   deny                                 -
        system          4.29G     max   deny                                 -
process.max-msg-qbytes
        privileged      64.0KB      -   deny                                 -
        system          16.0EB    max   deny                                 -
process.max-sem-ops
        privileged        512       -   deny                                 -
        system          2.15G     max   deny                                 -
process.max-sem-nsems
        privileged        512       -   deny                                 -
        system          32.8K     max   deny                                 -
process.max-address-space
        privileged      16.0EB    max   deny                                 -
        system          16.0EB    max   deny                                 -
process.max-file-descriptor
        basic             256       -   deny                              3320
        privileged      65.5K       -   deny                                 -
        system          2.15G     max   deny                                 -
process.max-core-size
        privileged      8.00EB    max   deny                                 -
        system          8.00EB    max   deny                                 -
process.max-stack-size
        basic           10.0MB      -   deny                              3320
        privileged      32.0TB      -   deny                                 -
        system          32.0TB    max   deny                                 -
process.max-data-size
        privileged      16.0EB    max   deny                                 -
        system          16.0EB    max   deny                                 -
process.max-file-size
        privileged      8.00EB    max   deny,signal=XFSZ                     -
        system          8.00EB    max   deny                                 -
process.max-cpu-time
        privileged      18.4Es    inf   signal=XCPU                          -
        system          18.4Es    inf   none                                 -
task.max-cpu-time
        usage               0s   
        system          18.4Es    inf   none                                 -
task.max-processes
        usage               2    
        system          2.15G     max   deny                                 -
task.max-lwps
        usage               3    
        system          2.15G     max   deny                                 -
project.max-contracts
        privileged      10.0K       -   deny                                 -
        system          2.15G     max   deny                                 -
project.max-locked-memory
        usage               0B   
        system          16.0EB    max   deny                                 -
project.max-port-ids
        privileged      8.19K       -   deny                                 -
        system          65.5K     max   deny                                 -
project.max-shm-memory
        privileged       510MB      -   deny                                 -
        system          16.0EB    max   deny                                 -
project.max-shm-ids
        privileged        128       -   deny                                 -
        system          16.8M     max   deny                                 -
project.max-msg-ids
        privileged        128       -   deny                                 -
        system          16.8M     max   deny                                 -
project.max-sem-ids
        privileged        128       -   deny                                 -
        system          16.8M     max   deny                                 -
project.max-crypto-memory
        usage               0B   
        privileged       510MB      -   deny                                 -
        system          16.0EB    max   deny                                 -
project.max-tasks
        usage               2    
        system          2.15G     max   deny                                 -
project.max-processes
        usage               4    
        system          2.15G     max   deny                                 -
project.max-lwps
        usage              11    
        system          2.15G     max   deny                                 -
project.cpu-cap
        usage               0    
        system          4.29G     inf   deny                                 -
project.cpu-shares
        usage               1    
        privileged          1       -   none                                 -
        system          65.5K     max   none                                 -
zone.max-lofi
        usage               0    
        system          18.4E     max   deny                                 -
zone.max-swap
        usage            180MB   
        system          16.0EB    max   deny                                 -
zone.max-locked-memory
        usage               0B   
        system          16.0EB    max   deny                                 -
zone.max-shm-memory
        system          16.0EB    max   deny                                 -
zone.max-shm-ids
        system          16.8M     max   deny                                 -
zone.max-sem-ids
        system          16.8M     max   deny                                 -
zone.max-msg-ids
        system          16.8M     max   deny                                 -
zone.max-processes
        usage              73    
        system          2.15G     max   deny                                 -
zone.max-lwps
        usage             384    
        system          2.15G     max   deny                                 -
zone.cpu-cap
        usage               0    
        system          4.29G     inf   deny                                 -
zone.cpu-shares
        usage               1    
        privileged          1       -   none                                 -
        system          65.5K     max   none

How to Use the `prctl` Command to Display Information for a Given Resource Control

Display the maximum file descriptor for the current shell that is running.

# prctl -n process.max-file-descriptor $$
process: 110453: -sh
NAME    PRIVILEGE       VALUE    FLAG   ACTION       RECIPIENT
process.max-file-descriptor
        basic             256       -   deny            11731
        privileged      65.5K       -   deny                 -
        system          2.15G     max   deny

How to Use `prctl` to Temporarily Change a Value

This example procedure uses the prctl command to temporarily add a new privileged value to deny the use of more than three LWPs per project for the x-files project. The result is comparable to the result in How to Set the Maximum Number of LWPs for Each Task in a Project.

Become root or assume an equivalent role.
Use newtask to join the x-files project.
```
# newtask -p x-files
```
Use the id command with the -p option to verify that the correct project has been joined.
```
# id -p
uid=0(root) gid=1(other) projid=101(x-files)
```
Add a new privileged value for project.max-lwps that limits the number of LWPs to three.
```
# prctl -n project.max-lwps -t privileged -v 3 -e deny -i project x-files
```

Verify the result.

# prctl -n project.max-lwps -i project x-files
process: 111108: csh
NAME    PRIVILEGE    VALUE    FLAG   ACTION            RECIPIENT
project.max-lwps
        usage          203
        privileged    1000       -   deny                      -
        system       2.15G     max   deny                      -

How to Use `prctl` to Lower a Resource Control Value

Become root or assume an equivalent role.
Use the prctl command with the -r option to change the lowest value of the process.max-file-descriptor resource control.
```
# prctl -n process.max-file-descriptor -r -v 128 $$
```

How to Use `prctl` to Display, Replace, and Verify the Value of a Control on a Project

Become root or assume an equivalent role.

Display the value of project.cpu-shares in the project group.staff.

# prctl -n project.cpu-shares -i project group.staff
project: 2: group.staff
NAME    PRIVILEGE       VALUE    FLAG   ACTION     RECIPIENT
project.cpu-shares
        usage               1
        privileged          1       -   none               -
        system          65.5K     max   none

Replace the current project.cpu-shares value 1 with the value 10.

# prctl -n project.cpu-shares -v 10 -r -i project group.staff

Display the value of project.cpu-shares in the project group.staff.

# prctl -n project.cpu-shares -i project group.staff
project: 2: group.staff
NAME    PRIVILEGE       VALUE    FLAG   ACTION     RECIPIENT
project.cpu-shares
        usage               1    
        privileged          1       -   none                                 -
        system          65.5K     max   none

Skip Navigation Links
Exit Print View
	Oracle Solaris 11.1 Administration: Oracle Solaris Zones, Oracle Solaris 10 Zones, and Resource Management Oracle Solaris 11.1 Information Library

How to Use the prctl Command to Display Default Resource Control Values

How to Use the prctl Command to Display Information for a Given Resource Control

How to Use prctl to Temporarily Change a Value

How to Use prctl to Lower a Resource Control Value

How to Use prctl to Display, Replace, and Verify the Value of a Control on a Project