syslog

Autres langues

Langue: ko

Version: 11 June 1995 (fedora - 25/11/07)

Autres sections - même nom

Section: 2 (Appels système)

이름

syslog - 커널 메시지 링 버퍼를 읽거나 소거한다; console_loglevel을 설정한다.

사용법

 #include <unistd.h>
 
 #include <linux/unistd.h>
 
 _syscall3(int, syslog, int, type, char *, bufp, int, len);
 
 int syslog(int type, char *bufp, int len);
 

설명

이것은 아마도 당신이 흥미를 가질만한 기능은 아니다. C라이브러리 인터페이스를 위해 syslog(3) 를 본다. 이 페이지는 단지 텅빈 커널 시스템 호출 인터페이스를 문서화했다. type인수는 syslog 에 의한 실행을 결정한다. kernel/printk.c 로부터 인용:
 /*
  * Commands to sys_syslog:
  *
  *      0 -- Close the log.  Currently a NOP.
  *      1 -- Open the log. Currently a NOP.
  *      2 -- Read from the log.
  *      3 -- Read up to the last 4k of messages in the ring buffer.
  *      4 -- Read and clear last 4k of messages in the ring buffer
  *      5 -- Clear ring buffer.
  *      6 -- Disable printk's to console
  *      7 -- Enable printk's to console
  *      8 -- Set level of messages printed to console
  */
 
기능 3은 비root 프로세스만을 허용한다. 커널 로그 버퍼
커널은 메시지가 커널함수 printk()/fh 인수로써 주어지는것이 저장된 LOG_BUF_LEN (4096, since 1.3.54: 8192, since 2.1.113: 16384)의 순환버퍼를 갖는다. 호출 syslog (2,buf,len) 는 이 커널 로그 버퍼가 비워지지 않을때 까지 대기한 후 대부분의 len바이트에서 버퍼 buf를 읽는다. 그것은 읽어들인 바이트 양을 반환한다. 로그에서 읽은 바이트는 로그버퍼로부터 사라진다: 정보는 한번만 읽을 수 있다. 이것은 사용자 프로그램이 /proc/kmsg 를 읽을때 커널에 의해 실행된 함수이다. 호출 syslog (3,buf,len) 는 로그버퍼로부터 마지막 len 바이트를 읽지만, 버퍼에 기록된 이상은 읽지는 못할 것이다. 호출 syslog (4,buf,len) 도 같다. 호출 syslog (5,dummy,idummy) 는 단지 'clear ring buffer' 명령을 실행한다. 메세지의 모든 텍스트행은 로그레벨이 있다. 이 레벨은 d가 1-7범위안의 <d>를 가진 시작행이 아니라면 DEFAULT_MESSAGE_LOGLEVEL - 1 (6)이다. 로그레벨의 전통적의미는 다음과 같이 <linux/kernel.h> 에 정의되어 있다:
 #define KERN_EMERG    "<0>"  /* system is unusable               */
 #define KERN_ALERT    "<1>"  /* action must be taken immediately */
 #define KERN_CRIT     "<2>"  /* critical conditions              */
 #define KERN_ERR      "<3>"  /* error conditions                 */
 #define KERN_WARNING  "<4>"  /* warning conditions               */
 #define KERN_NOTICE   "<5>"  /* normal but significant condition */
 #define KERN_INFO     "<6>"  /* informational                    */
 #define KERN_DEBUG    "<7>"  /* debug-level messages             */
 

반환값

에러시, -1이 반환되고, errno가 설정된다. 그렇지 않으면 2,3,4와 같은 형태를 위해 syslog()는 읽은 바이트 수를 반환하고, 그렇지 않으면 0이다.

에러

EPERM
시도는 console_loglevel을 바꾸거나 root권한이 없는 프로세스에 의해 커널 메세지 링 버퍼를 소거한다.
EINVAL
잘못된 배개변수.
ERESTARTSYS
시스템 호출은 아무것도 읽지 못하는 시그널에 의해 중단된다.

호환

이 시스템 호출은 리눅스에 특화되었다. 그리고 다른 프로그램에서는 쓰여지지 않는다.

관련 항목

syslog(3)