NGCTL(8)

명칭
ngctl - netgraph 제어 유틸리티

서식
ngctl [-d] [-f filename] [-n nodename] [command ...]

해설
ngctl 유틸리티는, netgraph 명령 발행에 사용 가능한, socket 타입의 netgraph 노드를 작성합니다. -f 플래그를 지정하지 않고, 명령행상에서 command 를 지정하지 않는 경우로, 표준 입력이 tty 일 때, ngctl (은)는 대화 모드에 들어갑니다. 그렇지 않은 경우, ngctl (은)는 주어진 명령 (복수가능)를 실행해, 곧바로 종료합니다.

노드는, 작성, 삭제, 상호 접속등이 가능합니다. 노드가 바이너리 / ASCII 제어 메세지의 변환을 서포트하고 있는 경우, 그 노드에 대해서 ASCII 형식의 제어 메세지를 송신 가능합니다.

대화 모드에서는, 소켓 노드가 수신한 모든 제어 메세지와 데이터 패킷을 ngctl (은)는 표시합니다. 제어 메세지에 대해서는, 송출원의 노드가 변환을 서포트하고 있는 경우에는, 메세지의 인수는 ASCII 형식에서 표시됩니다.

옵션은 다음과 같습니다:

-f nodeinfo
    지정한 파일로부터 명령을 읽어들입니다. 단일의 데쉬는 표준 입력을 나타냅니다. 공행 및 “#” (으)로부터 개시하는 행은 무시됩니다.

-n nodename
    신규 작성된 netgraph 노드에 nodename (을)를 할당합니다. 디폴트명은 ngctlXXX (이어)여, XXX 는 프로세스 ID 번호입니다.

-d  디버그용 장황 레벨을 증가합니다.

명령
ngctl 하지만 현재 서포트하고 있는 명령은 다음과 같습니다:

    connect    2 개의 노드의 접속
    debug      디버그용 장황 레벨의 취득/설정
    help       명령 요약의 표시 또는 커멘드 헬프의 취득
    list       전노드의 정보 표시
    mkpeer     신규 노드를 작성해 기존 노드에 접속
    msg        노드에 대한 ASCII 형식 메세지의 송신
    name       노드에의 이름 할당
    read       파일로부터의 명령 읽기와 실행
    rmhook     노드 훅의 절단
    show       노드 정보의 표시
    shutdown   노드의 셧다운
    status     노드로부터의 가독형식 상태 취득
    types      편입제의 전노드 타입의 표시
    write      데이터 패킷을 "hook" 라는 이름의 훅에 송신
    quit       프로그램의 종료

명령에는 별명을 가지는 것이 있습니다. 예를 들면 “ls” 하 “list” (와)과 같습니다. “help” 명령은, 사용 가능한 명령와 그러한 용법과 별명, 짧은 해설을 표시합니다.

진단

관련 항목
netgraph(3), netgraph(4), nghook(8)

역사
netgraph 시스템의 디자인과 최초의 실장은, Whistle Communications, Inc. 그리고, Whistle InterJet 전용으로 커스터마이즈 되었다 FreeBSD 2.2 그리고 행해졌습니다.

저자
Archie Cobbs <archie@whistle.com>