resource --- 資源使用信息?

資源限制?

資源的使用可以通過下面描述的 setrlimit() 函數(shù)來限制。每個資源都被一對限制所控制：一個軟限制和一個硬限制。軟限制是當(dāng)前的限制，并且可以由一個進程隨著時間的推移而降低或提高。軟限制永遠不能超過硬限制。硬限制可以降低到大于軟限制的任何數(shù)值，但不能提高。（只有擁有超級用戶有效UID的進程才能提高硬限制。)

可以被限制的具體資源取決于系統(tǒng)。它們在 man getrlimit(2) 中描述。 下面列出的資源在底層操作系統(tǒng)支持的情況下被支持；那些不能被操作系統(tǒng)檢查或控制的資源在本模塊中沒有為這些平臺定義。

resource.RLIM_INFINITY?

用來表示無限資源的極限的常數(shù)。

resource.getrlimit(resource)?

返回一個包含 resource 當(dāng)前軟限制和硬限制的元組。如果指定了一個無效的資源，則觸發(fā) ValueError ，如果底層系統(tǒng)調(diào)用意外失敗，則引發(fā) error 。

resource.setrlimit(resource, limits)?

設(shè)置 resource 的新的消耗極限。參數(shù) limits 必須是一個由兩個整數(shù)組成的元組 (soft, hard) ，描述了新的限制。 RLIM_INFINITY 的值可以用來請求一個無限的限制。

如果指定了一個無效的資源，如果新的軟限制超過了硬限制，或者如果一個進程試圖提高它的硬限制，將觸發(fā) ValueError 。當(dāng)資源的硬限制或系統(tǒng)限制不是無限時，指定一個 RLIM_INFINITY 的限制將導(dǎo)致 ValueError 。 一個有效 UID 為超級用戶的進程可以請求任何有效的限制值，包括無限，但如果請求的限制超過了系統(tǒng)規(guī)定的限制，則仍然會產(chǎn)生 ValueError 。

如果底層系統(tǒng)調(diào)用失敗， setrlimit 也可能觸發(fā) error 。

VxWorks只支持設(shè)置 RLIMIT_NOFILE 。

觸發(fā)一個 auditing event resource.setrlimit``使用參數(shù)  ``resource ， limits 。

resource.prlimit(pid, resource[, limits])?

將 setrlimit() 和 getrlimit() 合并為一個函數(shù)，支持獲取和設(shè)置任意進程的資源限制。如果 pid 為0，那么該調(diào)用適用于當(dāng)前進程。 resource 和 limits 的含義與 setrlimit() 相同，只是 limits 是可選的。

當(dāng) limits 沒有給出時，該函數(shù)返回進程 pid 的 resource 限制。當(dāng) limits 被給定時，進程的 resource 限制被設(shè)置，并返回以前的資源限制。

當(dāng) pid 找不到時，觸發(fā) ProcessLookupError ；當(dāng)用戶沒有進程的 CAP_SYS_RESOURCE 時，觸發(fā) PermissionError 。

觸發(fā)一個 auditing event resource.prlimit 帶有參數(shù) pid ， resource ， limits 。

Availability: Linux 2.6.36 或更新版本帶有 glibc 2.13 或更新版本

3.4 新版功能.

這些符號定義了資源的消耗可以通過下面描述的 setrlimit() 和 getrlimit() 函數(shù)來控制。這些符號的值正是 C 程序所使用的常數(shù)。

Unix man 頁面 getrlimit(2) 列出了可用的資源。注意，并非所有系統(tǒng)都使用相同的符號或相同的值來表示相同的資源。本模塊并不試圖掩蓋平臺的差異——沒有為某一平臺定義的符號在該平臺上將無法從本模塊中獲得。

resource.RLIMIT_CORE?

當(dāng)前進程可以創(chuàng)建的核心文件的最大大?。ㄒ宰止?jié)為單位）。如果需要更大的核心文件來包含整個進程的鏡像，這可能會導(dǎo)致創(chuàng)建一個部分核心文件。

resource.RLIMIT_CPU?

一個進程可以使用的最大處理器時間（以秒為單位）。如果超過了這個限制，一個 SIGXCPU 信號將被發(fā)送給進程。（參見 signal 模塊文檔，了解如何捕捉這個信號并做一些有用的事情，例如，將打開的文件刷新到磁盤上）。

resource.RLIMIT_FSIZE?

進程可能創(chuàng)建的文件的最大大小。

resource.RLIMIT_DATA?

進程的堆的最大大?。ㄒ宰止?jié)為單位）。

resource.RLIMIT_STACK?

當(dāng)前進程的調(diào)用堆棧的最大大?。ㄗ止?jié)）。 這只影響到多線程進程中主線程的堆棧。

resource.RLIMIT_RSS?

應(yīng)該提供給進程的最大常駐內(nèi)存大小。

resource.RLIMIT_NPROC?

當(dāng)前進程可能創(chuàng)建的最大進程數(shù)。

resource.RLIMIT_NOFILE?

當(dāng)前進程打開的文件描述符的最大數(shù)量。

resource.RLIMIT_OFILE?

BSD 對 RLIMIT_NOFILE 的命名。

resource.RLIMIT_MEMLOCK?

可能被鎖定在內(nèi)存中的最大地址空間。

resource.RLIMIT_VMEM?

進程可能占用的最大映射內(nèi)存區(qū)域。

resource.RLIMIT_AS?

進程可能占用的地址空間的最大區(qū)域（以字節(jié)為單位）。

resource.RLIMIT_MSGQUEUE?

可分配給 POSIX 消息隊列的字節(jié)數(shù)。

Availability: Linux 2.6.8 或更新版本。

3.4 新版功能.

resource.RLIMIT_NICE?

進程的 Nice 級別的上限（計算為 20 - rlim_cur ）。

Availability: Linux 2.6.12 或更新版本

3.4 新版功能.

resource.RLIMIT_RTPRIO?

實時優(yōu)先級的上限。

Availability: Linux 2.6.12 或更新版本

3.4 新版功能.

resource.RLIMIT_RTTIME?

在實時調(diào)度下，一個進程在不進行阻塞性系統(tǒng)調(diào)用的情況下，可以花費的 CPU 時間限制（以微秒計）。

Availability: Linux 2.6.25 或更新版本

3.4 新版功能.

resource.RLIMIT_SIGPENDING?

進程可能排隊的信號數(shù)量。

Availability: Linux 2.6.8 或更新版本。

3.4 新版功能.

resource.RLIMIT_SBSIZE?

這個用戶使用的套接字緩沖區(qū)的最大大小（字節(jié)數(shù)）。這限制了這個用戶在任何時候都可以持有的網(wǎng)絡(luò)內(nèi)存數(shù)量，因此也限制了 mbufs 的數(shù)量。

Availability: FreeBSD 9 或更新版本

3.4 新版功能.

resource.RLIMIT_SWAP?

這個用戶 ID 的所有進程可能保留或使用的交換空間的最大大?。ㄗ止?jié)數(shù)）。這個限制只有在 vm.overcommit sysctl的第 1 位被置 1 時才會被強制執(zhí)行。請參閱 tuning(7) 以獲得關(guān)于這個系統(tǒng)檢測器的完整介紹。

Availability: FreeBSD 9 或更新版本

3.4 新版功能.

resource.RLIMIT_NPTS?

該用戶 ID 創(chuàng)建的偽終端的最大數(shù)量。

Availability: FreeBSD 9 或更新版本

3.4 新版功能.

resource.RLIMIT_KQUEUES?

這個用戶 ID 被允許創(chuàng)建的最大 kqueue 數(shù)量。

Availability: FreeBSD 11 或更新版本。

3.10 新版功能.

資源用量?

這些函數(shù)被用來檢索資源使用信息。

resource.getrusage(who)?

這個函數(shù)返回一個對象，描述當(dāng)前進程或其子進程所消耗的資源，由 who 參數(shù)指定。 who 參數(shù)應(yīng)該使用下面描述的 RUSAGE_* 常數(shù)之一來指定。

一個簡單的示例：

from resource import *
import time

# a non CPU-bound task
time.sleep(3)
print(getrusage(RUSAGE_SELF))

# a CPU-bound task
for i in range(10 ** 8):
   _ = 1 + 1
print(getrusage(RUSAGE_SELF))

返回值的字段分別描述了某一特定系統(tǒng)資源的使用情況，例如，在用戶模式下運行的時間或進程從主內(nèi)存中換出的次數(shù)。有些值取決于內(nèi)部的時鐘周期，例如進程使用的內(nèi)存量。

為了向后兼容，返回值也可以作為一個 16 個元素的元組來訪問。

返回值中的 ru_utime 和 ru_stime 字段是浮點值，分別代表在用戶模式下執(zhí)行的時間和在系統(tǒng)模式下執(zhí)行的時間。其余的值是整數(shù)。關(guān)于這些值的詳細信息，請查閱 getrusage(2) man page 。這里介紹一個簡短的摘要。

索引	字段	資源
0	ru_utime	用戶模式下的時間（浮點數(shù)秒）
1	ru_stime	系統(tǒng)模式下的時間（浮點數(shù)秒）
2	ru_maxrss	最大的常駐內(nèi)存大小
3	ru_ixrss	共享內(nèi)存大小
4	ru_idrss	未共享的內(nèi)存大小
5	ru_isrss	未共享的堆棧大小
6	ru_minflt	不需要 I/O 的頁面故障數(shù)
7	ru_majflt	需要 I/O 的頁面故障數(shù)
8	ru_nswap	swap out 的數(shù)量
9	ru_inblock	塊輸入操作數(shù)
10	ru_oublock	塊輸出操作數(shù)
11	ru_msgsnd	發(fā)送消息數(shù)
12	ru_msgrcv	收到消息數(shù)
13	ru_nsignals	收到信號數(shù)
14	ru_nvcsw	主動上下文切換
15	ru_nivcsw	被動上下文切換

如果指定了一個無效的 who 參數(shù)，這個函數(shù)將觸發(fā)一個 ValueError 。在特殊情況下，它也可能觸發(fā) error 異常。

resource.getpagesize()?

返回一個系統(tǒng)頁面的字節(jié)數(shù)。（這不需要和硬件頁的大小相同）。

下面的 RUSAGE_* 符號被傳遞給 getrusage() 函數(shù)，以指定應(yīng)該為哪些進程提供信息。

resource.RUSAGE_SELF?

傳遞給 getrusage() 以請求調(diào)用進程消耗的資源，這是進程中所有線程使用的資源總和。

resource.RUSAGE_CHILDREN?

傳遞給 getrusage() 以請求被終止和等待的調(diào)用進程的子進程所消耗的資源。

resource.RUSAGE_BOTH?

傳遞給 getrusage() 以請求當(dāng)前進程和子進程所消耗的資源。并非所有系統(tǒng)都能使用。

resource.RUSAGE_THREAD?

傳遞給 getrusage() 以請求當(dāng)前線程所消耗的資源。 并非所有系統(tǒng)都能使用。

3.2 新版功能.