Man page  — SYSCTL_CTX_INIT

내부적으로는, 문맥은 queue(3) TAILQ 링크 리스트로서 표현되고 있습니다. 그 리스트는 struct sysctl_ctx_entry 엔트리로부터 완성되어 있습니다.

struct sysctl_ctx_entry {
        struct sysctl_oid *entry;
        TAILQ_ENTRY(sysctl_ctx_entry) link;
};

TAILQ_HEAD(sysctl_ctx_list, sysctl_ctx_entry);

각각의 문맥 엔트리는, 그것이 관리하는 1 개(살)의 동적인 oid 를 가리킵니다. 새롭게 작성된 oid 는 항상 리스트의 최초로 삽입됩니다.

sysctl_ctx_free() 함수는 문맥 및 그것이 관리하는 관련지을 수 있었던 oid 를 삭제합니다. 그 함수가 성공해 완료했을 경우에는, 모든 관리되고 있는 oid 는 등록 말소 (트리로부터 삭제)되어 모든 그것들에 할당할 수 있었던 메모리와 함께 해방되어 똑같이 문맥의 엔트리도 해방되고 있습니다.

삭제 조작은 2 스텝에서 실행됩니다. 최초로, 각각의 문맥 엔트리를 위해서(때문에), 리소스의 해방을 억제하는 파라미터 del (을)를 0 으로 설정해, 함수 sysctl_remove_oid(9) 하지만 불려 갑니다. 이 스텝에서 에러가 없는 경우에는, sysctl_ctx_free() (은)는 다음의 스텝으로 이행합니다. 최초의 스텝이 실패했을 경우에는, 그 문맥에 관련지을 수 있었다 모든 등록 말소된 oid 가 재등록됩니다.

주의: 대부분의 경우, 프로그래머는 oid 의 작성시에 oid 번호로서 OID_AUTO (을)를 명시합니다. 그렇지만, 트리에 oid 를 등록하고 있는 동안에, 이 번호는 99 보다 큰 최초의 이용 가능한 번호로 변경됩니다. 문맥 삭제의 최초의 스텝이 실패했을 경우, oid 의 재등록은 이미 할당할 수 있고 있는 oid 번호를 변경하지 않습니다 (OID_AUTO 와는 다릅니다). 이것은, 재등록된 엔트리가 트리안의 원래의 위치를 유지하고 있는 것을 프로텍션합니다.

2 번째의 스텝은, 동적인 oid 의 삭제를 실제로 실행합니다. sysctl_remove_oid(9) (은)는 최초 (즉, 최신의 엔트리)부터 시작해, 문맥 리스트를 통해 반복합니다. 중요: 이 때, 이 함수는 트리로부터 oid 를 삭제하는 것 만이 아니고, 모든 문맥의 메모리는 물론, (oid_refcount == 0 이면) oid 의 메모리도 해방합니다.

sysctl_ctx_entry_add() 함수는 기존의 동적인 oid 의 문맥에의 추가를 가능하게 합니다.

sysctl_ctx_entry_del() 함수는 문맥으로부터 엔트리를 없앱니다. 중요: 이 경우, 대응한다 struct sysctl_ctx_entry 만이 해방됩니다만, oidp 포인터는 그대로 남습니다. 그 후는, 프로그래머에게 이 oid 에 할당할 수 있었던 리소스의 관리의 책임이 있습니다.

sysctl_ctx_entry_find() 함수는 주어졌다 oidp (을)를 문맥 리스트중에서 검색해, 발견되었다 struct, sysctl_ctx_entry 에의 포인터 또는 NULL (을)를 돌려줍니다.