.\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) rmt. 8 8.3 (Berkeley) 6/1/94 .\" %FreeBSD: src/usr.sbin/rmt/rmt. 8, v 1.12 2002/07/14 14:45:29 charnier Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man8/rmt. 8, v 1.12 2002/11/18 06:17:45 horikawa Exp $ .\" .Dd June 1, 1994 .Dt RMT 8 .Os .Sh 명칭 .Nm rmt .Nd 리모트 프로그램으로부터 자기테이프의 조작을 행하기 위한 프로토콜 모듈 .Sh 서식 .Nm .Sh 해설 .Nm 유틸리티는, 리모트 덤프 및 restore를 행하는 프로그램으로부터, 프로세스간 통신을 이용해 자기테이프 드라이브를 조작하기 위해서 이용됩니다. 통상은 .Xr rexec 3 혹은 .Xr rcmd 3 (으)로부터의 호출에 응해 기동됩니다. .Pp .Nm 유틸리티는, 자기테이프의 조작 요구를 받아들여 명령을 실행합니다. 그 후, 상태를 반환합니다. 모든 응답은, .Tn ASCII 캐릭터 라인 및 이하의 2 개의 형식을 조합해 행해집니다. 명령 실행이 성공했을 경우는, 이하의 응답이 있습니다. .Bd -ragged -offset indent .Sm off .Sy A Ar number No \en .Sm on .Ed .Pp .Ar number (은)는, 10 진의 .Tn ASCII 표현입니다. 명령 실행이 실패했을 경우에는, 이하의 응답이 있습니다. .Bd -ragged -offset indent .Sm off .Xo Sy E Ar error-number .No \en Ar error-message .No \en .Xc .Sm on .Ed .Pp .Ar error-number (은)는, .Xr intro 2 에 기술이 있는 에러 번호이며, .Ar error-message (은)는, .Xr perror 3 에 의해 출력되는 에러 캐릭터 라인입니다. 프로토콜은, 이하의 명령을 포함해, 명령와 인수의 사이, 혹은 인수간으로는 스페이스는 삽입되지 않습니다. .Ql \en 의 표시는, 그 부분에서 개행이 요구되고 있습니다: .Bl -tag -width Ds .Sm off .It Xo Sy \&O Ar device .No \en Ar mode No \en .Xc .Sm on 지정되었다 .Ar device (을)를 .Ar mode 그리고 지정된 속성으로 오픈합니다. .Ar device 하 풀 패스로 지정되어 .Ar mode 하 .Xr open 2 그리고 이용되는 10 진의 .Tn ASCII 표현입니다. 벌써 디바이스가 오픈되고 있었을 경우, 그 디바이스는 일단 클로우즈 되어 다시 오픈됩니다. .Sm off .It Xo Sy C Ar device No \en .Xc .Sm on 현재 오픈되고 있는 디바이스를 클로우즈 합니다. .Ar device 지정은 무시됩니다. .Sm off .It Xo Sy L .Ar whence No \en .Ar offset No \en .Xc .Sm on 지정된 인수를 이용해, .Xr lseek 2 (을)를 실행합니다. 반환치의 의미는, .Xr lseek 시스템 콜의 그것과 같습니다. .Sm off .It Sy W Ar count No \en .Sm on 오픈되고 있는 디바이스에 대해, 데이터를 기입합니다. .Nm 유틸리티는, 요구원으로부터 .Ar count 바이트의 데이터를 읽어들입니다. 예기치 않은 EOF 를 읽어들였을 경우, 이상종료(ABEND) 합니다. 본명령의 반환치는, .Xr write 2 시스템 콜과 같습니다. .Sm off .It Sy R Ar count No \en .Sm on 오픈되고 있는 디바이스로부터 .Ar count 바이트만의 데이터를 읽어들입니다. .Ar count 하지만 데이터 버퍼의 사이즈 (10 k바이트)를 넘는 경우, 데이터 버퍼 사이즈에 절약할 수 있습니다. .Nm 유틸리티는 .Xr read 2 시스템 콜을 실행해, 읽기가 성공하면(자) .Sm off .Sy A Ar count-read No \en .Sm on (이)라고 대답합니다. 그렇지 않으면, 표준적인 형식에서 에러가 반환됩니다. 읽기가 성공하면(자), 읽힌 데이터 (은)는 요구 바탕으로 송신됩니다. .Sm off .It Xo Sy I Ar operation .No \en Ar count No \en .Xc .Sm on 지정된 인수를 이용해 .Xr ioctl 2 의 .Dv MTIOCOP 리퀘스트를 실행합니다. 인수는, 10 진의 .Tn ASCII 표현으로 옮겨져 .Xr ioctl 2 그리고 사용하는 구조체의 멤버 .Ar mt_op 및 .Ar mt_count 에 각각 격납됩니다. 조작이 성공했을 경우의 반환치는, 인수 .Ar count 의 값입니다. .It Sy S .Xr ioctl 2 시스템 콜의 .Dv MTIOCGET 리퀘스트를 이용해 오픈되고 있다 디바이스 상태를 반환합니다. 조작이 성공하면(자), 스테이터스 버퍼의 사이즈와 함께 ``ack''가 송신됩니다. 그리고 스테이터스 버퍼가 (바이너리 형식에서) 송신됩니다. .El .Pp 상기 이외의 명령을 .Nm 하지만 수신했을 경우, .Nm (은)는 종료합니다. .Sh 진단 모든 대답은, 상기대로입니다. .Sh 관련 항목 .Xr rcmd 3 , .Xr rexec 3 , .Xr mtio 4 , .Xr rdump 8 , .Xr rrestore 8 .Sh 버그 본명령을 리모트 파일 액세스 프로토콜로서 사용하지 마세요. .Sh 역사 .Nm 유틸리티는 .Bx 4.2 (으)로부터 등장했습니다.