Linux Certif

Toute la documentation sur la certification Linux LPI

sysctl

이름

sysctl - 시스템 파라미터들을 읽고 쓴다.

사용법

#include <unistd.h>

#include <linux/unistd.h>

#include <linux/sysctl.h>

_syscall1(int, _sysctl, struct __sysctl_args *, args);

int _sysctl(struct __sysctl_args *args);

설명

_sysctl 시스템 콜은 커널 파리미터들을 읽고 쓴다. 예를 들어, 호스트 이름이나 열린 파일들의 최대 수 등이다. 인자는 다음과 같은 형태이다:

 struct __sysctl_args {
         int *name;        /* 변수를 가리키는 integer vector */
         int nlen;         /* 이 벡터의 길이*/
         void *oldval;     /* 0 또는 예전 값을 저장하기 위한 주소*/
         size_t *oldlenp;  /* 예전 값을 위해 이용할수 있는 공간,
                                           예전 값의 실제 크기에 의해 위에 쓰여진다.*/
         void *newval;     /* 0 또는 새로운 값의 주소*/
         size_t newlen;    /* 새로운 값의 크기*/
 };
 

이 함수는 트리 구조에서 탐색을 하며 /proc/sys아래의 디렉토리 트리와 비슷하다. 그리고 만일 요구된 아이템이 발견된다면 몇몇 적당한 루틴들이 이 값을 읽거나 번경하기 위해서 호출된다.

예제

 #include <linux/unistd.h>
 #include <linux/types.h>
 #include <linux/sysctl.h>
 
 _syscall1(int, _sysctl, struct __sysctl_args *, args);
 int sysctl(int *name, int nlen, void *oldval, size_t *oldlenp,
            void *newval, size_t newlen)
 {
         struct __sysctl_args args={name,nlen,oldval,oldlenp,newval,newlen};
         return _sysctl(&args);
 }
 
 #define SIZE(x) sizeof(x)/sizeof(x[0])
 #define OSNAMESZ 100
 
 char osname[OSNAMESZ];
 int osnamelth;
 int name[] = { CTL_KERN, KERN_OSTYPE };
 
 main(){
         osnamelth = SIZE(osname);
         if (sysctl(name, SIZE(name), osname, &osnamelth, 0, 0))
                 perror("sysctl");
         else
                 printf("This machine is running %*s\n", osnamelth, osname);
         return 0;
 }
 

반환값

성공시, _sysctl 는 0이 리턴되다. 그렇지 않으면, -1 값이 리턴되며 errno 는 에러를 가리키며 설정된다.

에러

ENOTDIR

name 이 발견되지 않았다.

EPERM

만난 `directories'중 하나에 대한 탐색 허가권이 없거나, oldval 가 0이 아닌곳의 읽기 허가권이 없거나, newval 이 0이 아닌곳의 쓰기 허가권이 없다.

EFAULT

호출은 non-NULL인 oldval 를 설정하여 전 값을 요구했지만, oldlenp에 있는 곳은 0 을 허가한다.

호환

이 함수는 리눅스에 의존하며 호환성을 염두에 둔 프로그램에서 사용해서는 안된다.

sysctl 시스템 콜은 Linux 버전 1.3.57이후부터 존재한다. 이것은 4.4BSD에 기반을 두고 있다. 단지 리눅스만이 /proc/sys 를 반영하고 있으며 객체 이름 구조들은 Linux와 BSD 4.4에서 서로 다르다. 그러나, sysctl(2)함수의 선언은 양쪽 모두 같다.

버그

객체 이름들은 커널 버전에 따라 다른다. 이 시스템 콜은 응용프로그램에서는 쓸모가 없다. 대신에 /proc/sys 를 사용해라.
이용할수 있는 모든 객체들이 문서화 되어 있지는 않다.
아직은 /proc/sys/kernel/ostype에 쓰기를 하여 OS를 변경하는것은 가능하지 않다.

관련 항목

proc(5)

역자

정강훈 <skyeyes@soback.kornet.net>, 2000년 7월 8일