Sun Cluster Geographic Edition 참조 설명서

머리말

Sun Cluster Geographic Edition System 참조 설명서는 SunTM Cluster Geographic Edition 소프트웨어의 명령, 기능 및 기타 공용 인터페이스에 대한 참조 정보를 제공합니다. 이 책은 Sun 소프트웨어 및 하드웨어에 대한 방대한 지식을 갖고 있는 숙련된 시스템 관리자를 위한 것입니다. 이 책은 계획 수립 또는 판촉용 안내서가 아닙니다. 이 설명서를 이해하려면 SolarisTM 운영 체제에 대해 잘 알고 있으며 Sun Cluster 소프트웨어에서 사용하는 볼륨 관리자 소프트웨어에 익숙해야 합니다.

초보 사용자와 Solaris 운영 체제에 익숙한 사용자 모두 온라인 매뉴얼 페이지를 사용하여 SPARC® 기반 시스템 및 해당 기능에 대한 정보를 얻을 수 있습니다.

매뉴얼 페이지는 “이 명령이 어떤 일을 합니까?”라는 질문에 간결하게 대답하기 위한 것입니다. 매뉴얼 페이지는 일반적으로 참조 설명서를 구성합니다. 매뉴얼 페이지는 학습용이 아닙니다.

개요

다음에 각 매뉴얼 페이지 절 및 해당 절이 참조하는 정보의 간략한 설명이 들어 있습니다.

다음은 매뉴얼 페이지에 대한 일반 형식입니다. 각 매뉴얼 절의 매뉴얼 페이지는 일반적으로 이 순서를 따르지만 필요한 표제만을 포함합니다. 예를 들어 보고할 수 있는 버그가 없는 경우 BUGS 절은 포함되지 않습니다. 자세한 정보 및 각 절에 대한 세부사항은 서론 페이지를 참조하고, 매뉴얼 페이지에 대한 일반 정보는 man(1)을 참조하십시오.

이름

이 절은 문서화되는 명령 또는 함수의 이름을 제공하며, 이들이 수행하는 일의 간단한 설명이 뒤따릅니다.

개관

이 절은 명령 또는 함수의 구문을 표시합니다. 명령 또는 파일이 표준 경로에 존재하지 않는 경우 전체 경로 이름이 표시됩니다. 옵션 및 인수는 다른 인수 순서가 필요하지 않는 한 단일 문자 인수가 먼저 오고 인수를 갖는 옵션이 뒤에 오면서 영문자 순으로 정렬됩니다.

다음 특수 문자가 이 절에서 사용됩니다.

[ ]

대괄호. 이러한 대괄호로 묶은 옵션이나 인수는 선택사항입니다. 대괄호가 생략되는 경우 인수가 반드시 지정되어야 합니다.

. . .

생략 부호. 이전 인수에 대해 여러 값을 제공할 수 있거나, 이전 인수를 여러 번 지정할 수 있습니다(예: “filename) . . .“ .

|

분리 기호. 이 문자로 구분되는 인수 중 한 번에 하나만 지정할 수 있습니다.

{ }

중괄호. 중괄호로 묶은 옵션 및/또는 인수는 상호의존적입니다. 중괄호 내의 모든 문자를 하나의 단위로 처리해야 합니다.

프로토콜

이 절은 하위절 3R에서만 발생하고 프로토콜 설명 파일을 표시합니다.

설명

이 절은 서비스의 기능성 및 동작을 정의합니다. 따라서 명령이 수행하는 일을 간결하게 설명합니다. 설명은 옵션을 논의하거나 예제를 인용하지 않습니다. 대화식 명령, 하위 명령, 요청, 매크로 및 함수는 사용법 아래에서 설명됩니다.

IOCTL

이 절은 7 절의 페이지에서만 나타납니다. ioctl(2) 시스템 호출에 적당한 매개변수를 제공하는 장치 클래스만이 ioctl로 불리우며 고유한 표제를 생성합니다. 특정 장치에 대한 ioctl 호출이 영문자순으로(특정 장치에 대한 매뉴얼 페이지에서) 나열됩니다. ioctl 호출은 특정 장치 클래스에 사용됩니다. 이러한 모든 호출은 mtio(7I)와 같이 io 종료를 갖습니다.

옵션

이 절은 각 옵션이 수행하는 일의 간결한 요약과 함께 명령 옵션을 나열합니다. 옵션은 글자 뜻대로 그리고 개요 절에서 나타나는 순서로 나열됩니다. 옵션에 대한 가능한 인수는 옵션 아래에서 논의되며, 적합한 경우 기본값이 제공됩니다.

피연산자

이 절은 명령 피연산자를 나열하고 이들이 명령의 조치에 영향을 주는 방법을 설명합니다.

출력

이 절은 명령에 의해 생성되는 출력—표준 출력, 표준 오류 또는 출력 파일—을 설명합니다.

리턴 값

매뉴얼 페이지가 값을 리턴하는 함수를 문서화하는 경우 이 절은 이들 값을 나열하고 해당 값이 리턴되는 조건을 설명합니다. 함수가 0 또는 –1 같은 상수값만을 리턴하는 경우 이들 값은 태그가 있는 절에 나열됩니다. 그렇지 않으면 단일 절이 각 함수의 리턴 값을 설명합니다. 무효로 선언되는 함수는 값을 리턴하지 않으므로 리턴 값에서 논의되지 않습니다.

오류

실패 시에 대부분의 함수는 실패한 이유를 표시하는 전역 변수 errno에 오류 코드를 배치합니다. 이 절은 함수가 생성할 수 있는 모든 오류 코드를 영문자순으로 나열하고 각 오류를 유발하는 조건을 설명합니다. 둘 이상의 조건이 동일한 오류를 유발할 수 있을 때 각 조건은 오류 코드 아래의 개별 절에 설명됩니다.

사용법

이 절은 깊이있는 설명을 필요한 특수 규칙, 기능 및 명령을 나열합니다. 여기에 나열되는 하위 절은 내장 함수를 설명하는 데 사용됩니다.

  • 명령
  • 수정자
  • 변수
  • 표현식
  • 입력 문법

예제

이 절은 사용법이나 명령 또는 함수를 사용하는 방법의 예제를 제공합니다. 가능할 때마다 명령줄 항목 및 시스템 응답을 포함하는 전체 예제가 표시됩니다. 예제가 제공될 때마다 프롬프트가 example%로, 사용자가 수퍼유저여야 하는 경우 example#로 표시됩니다. 예제 뒤에 설명, 변수 대체 규칙 또는 리턴되는 값이 뒤따릅니다. 대부분의 예제는 개요, 설명, 옵션 및 사용법 절의 개념을 보여줍니다.

환경 변수

이 절은 명령 또는 함수가 영향을 미치는 모든 환경 변수를 나열하고, 그 효과의 간략한 설명이 뒤따릅니다.

종료 상태

이 절은 명령이 호출 프로그램이나 쉘로 리턴하는 값과 이들 값이 리턴되게 하는 조건을 나열합니다. 대개 성공적인 완료의 경우 0이 리턴되고, 다양한 오류 조건의 경우 0 이외의 값이 리턴됩니다.

파일

이 절은 매뉴얼 페이지 참조하는 모든 파일, 관심이 있는 파일, 명령에 의해 작성되거나 필요한 파일을 나열합니다. 각 파일 이름 뒤에 설명식 요약이나 설명이 뒤따릅니다.

속성

이 절은 속성 유형 및 해당하는 값을 정의하여 명령, 유틸리티 및 장치 드라이버의 특성을 나열합니다. 자세한 정보는 속성(5)을 참조하십시오.

기타 참조

이 절은 기타 매뉴얼 페이지, Sun 문서 및 타사 참고서적에 대한 참조를 나열합니다.

진단

이 절은 오류를 유발한 조건의 간략한 설명과 함께 진단 메시지를 나열합니다.

경고

이 절은 작업 조건에 심각하게 영향을 미칠 수 있는 특수 조건에 대한 경고를 나열합니다. 경고는 진단의 목록입니다.

이 절은 페이지의 다른 곳에 속하지 않는 추가 정보를 나열합니다. 주는 사용자의 특별한 관심이 있는 점을 다룹니다. 중요한 정보는 여기에서 다루어지지 않습니다.

버그

이 절은 알려진 버그를 설명하며, 가능할 때는 언제나 해결책을 제안합니다.