.\" Copyright (c) 1998 Dag-Erling Coiean Smoograv .\" 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. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. .\" .\" $Id: fetch.3,v 1.3 2002/11/19 19:47:37 perky Exp $ .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/fetch. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd July 1, 1998 .Dt FETCH 3 .Os .Sh 명칭 .Nm fetchGetURL , .Nm fetchPutURL , .Nm fetchStatURL , .Nm fetchListURL , .Nm fetchParseURL , .Nm fetchGet , .Nm fetchPut , .Nm fetchStat , .Nm fetchList , .Nm fetchGetFile , .Nm fetchPutFile , .Nm fetchStatFile , .Nm fetchListFile , .Nm fetchGetHTTP , .Nm fetchPutHTTP , .Nm fetchStatHTTP , .Nm fetchListHTTP , .Nm fetchGetFTP , .Nm fetchPutFTP .Nm fetchStatFTP .Nm fetchListFTP , .Nd 파일 전송 프로그램 라이브러리 .Sh 서식 .Fd #include .Fd #include .Fd #include .Ft FILE * .Fn fetchGetURL "char *URL" "char *flags" .Ft FILE * .Fn fetchPutURL "char *URL" "char *flags" .Ft int .Fn fetchStatURL "char *URL" "struct url_stat *us" "char *flags" .Ft struct url_ent * .Fn fetchListURL "char *URL" "char *flags" .Ft struct url * .Fn fetchParseURL "char *URL" "char *flags" .Ft FILE * .Fn fetchGet "struct url *URL" "char *flags" .Ft FILE * .Fn fetchPut "struct url *URL" "char *flags" .Ft int .Fn fetchStat "struct url *URL" "struct url_stat *us" "char *flags" .Ft struct url_ent * .Fn fetchList "struct url *" "char *flags" .Ft FILE * .Fn fetchGetFile "struct url *u" "char *flags" .Ft FILE * .Fn fetchPutFile "struct url *u" "char *flags" .Ft int .Fn fetchStatFile "struct url *URL" "struct url_stat *us" "char *flags" .Ft struct url_ent * .Fn fetchListFile "struct url *" "char *flags" .Ft FILE * .Fn fetchGetHTTP "struct url *u" "char *flags" .Ft FILE * .Fn fetchPutHTTP "struct url *u" "char *flags" .Ft int .Fn fetchStatHTTP "struct url *URL" "struct url_stat *us" "char *flags" .Ft struct url_ent * .Fn fetchListHTTP "struct url *" "char *flags" .Ft FILE * .Fn fetchGetFTP "struct url *u" "char *flags" .Ft FILE * .Fn fetchPutFTP "struct url *u" "char *flags" .Ft int .Fn fetchStatFTP "struct url *URL" "struct url_stat *us" "char *flags" .Ft struct url_ent * .Fn fetchListFTP "struct url *" "char *flags" .Sh 해설 이 함수는, URL (Uniform Resource Locators) (을)를 사용해 파일의 취득과 업 로드를 행하는, 고레벨인 프로그램 라이브러리를 실현합니다. .Pp .Fn fetchGetURL (와)과 .Fn fetchPutURL (은)는, .Nm fetch 프로그램 라이브러리의 인터페이스를 구성합니다. 이 함수는 건네받은 URL 를 검사해 전송 수법을 결정해 적절한 저레벨 함수를 호출해 실제의 전송을 실행합니다. .Fa flags 인수는, 전송 옵션을 지정하는 캐릭터의 string입니다. 각각의 플래그의 의미는 스킴에 따라서 다르므로, 이하의 적절한 섹션을 참조해 주세요. .Pp .Fn fetchStatURL (은)는, 요구된 문서의 메타데이타를 입수해, 제 2 인수가 가리키는 구조체에 데이터를 입력하려고 합니다. .Fa url_stat 구조체는, .Aq Pa fetch.h 그리고 이하와 같이 정의되고 있습니다. .Bd -literal struct url_stat { off_t size; time_t atime; time_t mtime; }; .Ed .Pp .Fn fetchListURL (은)는, 지정된 URL 가 가리키는 디렉토리의 내용을 리스트 하려고 합니다. 문제가 없으면, malloc 로 할당해졌다 .Fa url_ent 구조체의 배열을 되돌립니다. .Fa url_ent 구조체는, .Aq Pa fetch.h 그리고 이하와 같이 정의되고 있습니다. .Bd -literal struct url_ent { char name[MAXPATHLEN]; struct url_stat stat; }; .Ed .Pp 리스트는, 이름이 없는 엔트리로 끝납니다. .Pp .Fn fetchListURL 하지만 되돌리는 포인터는, .Fn free 그리고 해방해 주세요. .Pp .Fn fetchParseURL (은)는 널 캐릭터로 끝나는 string의 URL 를 취해, RFC1738 에 규정되고 있다 Common Internet Scheme Syntax 에 따라, 그 URL 를 컴퍼넌트 함수로 분할합니다. 이 문장구조법을 만드는 정규 표현은 이하대로입니다. .Bd -literal :(//((:)? @)? (:)? )? /()? .Ed .Pp URL 의 일부의 컴퍼넌트는, 모든 URL 스킴으로 중요하지 않는 것이 있는 것에 주의해 주세요. 예를 들어 파일 스킴에서는, 컴퍼넌트와 컴퍼넌트 밖에 필요 없습니다. .Pp .Fn fetchParseURL 하지만 되돌리는 포인터는, .Fn free 그리고 해방해 주세요. .Pp .Fn fetchGet , .Fn fetchPut , .Fn fetchStat (은)는, 포인터의 형식의 사전 해석이 끝난 URL 가 string는 아니고 .Fa struct url 그리고 필요하게 되는 것을 제외하면, .Fn fetchGetURL , .Fn fetchPutURL , .Fn fetchStatURL (을)를 닮아 있습니다. .Pp 모든 .Fn fetchGetXXX 함수와 .Fn fetchPutXXX 함수는, 요구된 문서로부터의 데이터의 독포함이나 요구된 문서에의 데이터의 기록에 사용할 수 있는 스트림의 포인터를 되돌립니다. 각각의 액세스 수법의 시스템 자세한 것은 다릅니다만, .Fn fetchGetXXX 함수가 되돌리는 스트림은 독포함 전용으로, .Fn fetchPutXXX 하지만 되돌리는 스트림은 기록 전용이라고 일반적으로 가정됩니다. .Sh 파일 스킴 .Fn fetchGetFile (와)과 .Fn fetchPutFile 그럼, 로컬에 mount 된 파일 시스템의 파일인 문서에 액세스 할 수 있습니다. URL 의 컴퍼넌트만이 사용됩니다. .Pp .Fn fetchGetFile (은)는 플래그를 받아들이지 않습니다. .Pp .Fn fetchPutFile (은)는, .Fa a 플래그 (파일에 추가)를 받아들입니다. 이 플래그를 지정했을 경우, .Fn fetchPutFile 하지만 되돌리는 스트림에 기입해진 데이터는, 파일의 전의 내용을 옮겨놓는 것이 아니라 파일의 전의 내용에 추가됩니다. .Sh FTP 스킴 .Fn fetchGetFTP (와)과 .Fn fetchPutFTP (은)는, RFC959 에 기술되고 있도록(듯이) FTP 프로토콜을 실현합니다. .Pp .Fa p 플래그 (수동)를 지정하면(자), 능동적은 아니고 수동적인 접속이 시험 받습니다. .Pp 유저명이나 패스워드를 지정하지 않으면 .Nm fetch 프로그램 라이브러리는, 유저명 "ftp", 패스워드 "ftp" 로 익명 로그인을 시험합니다. .Sh HTTP 스킴 .Fn fetchGetHTTP 함수와 .Fn fetchPutHTTP 함수는, HTTP/1. 1 프로토콜을 실현합니다. 이 함수는, RFC2068 에 준거할 가능성이 있습니다. .Pp .Nm fetch 프로그램 라이브러리와 조화를 이루는 방법으로 HTTP PUT 수법을 실현하는 적절한 방법이 없는 것 같아서, .Fn fetchPutHTTP (은)는 현재로서는 실현되고 있지 않습니다. .Sh 반환값 .Fn fetchParseURL (은)는, URL 의 각각의 컴퍼넌트를 포함한다 .Fa struct url 의 포인터를 되돌립니다. 메모리를 할당할 수 없는 경우, 또는 URL 의 문장구조법이 올바르지 않은 경우, .Fn fetchParseURL (은)는 NULL 포인터를 되돌립니다. .Pp .Fn fetchStat 함수는, 문제가 없으면 0 을 되돌려, 문제가 있는 경우는 -1 을 되돌립니다. .Pp 그 외 모든 함수는, 요구된 문서에의 액세스에 사용할 수 있다 스트림의 포인터를 되돌립니다. 에러가 발생했을 경우는 NULL 를 되돌립니다. .Pp .Nm Libfetch (은)는, Common Error Library .Nm ( libcom_err ) (을)를 사용해 에러를 보고합니다. .Fn com_err 에게 건네지는 에러 코드는 이하대로입니다. .Bl -tag -width Er .It Bq Er FETCH_ABORT 오퍼레이션이 이상종료(ABEND) 했습니다. .It Bq Er FETCH_AUTH 인증이 에러가 되었습니다. .It Bq Er FETCH_DOWN 서비스를 사용할 수 없습니다. .It Bq Er FETCH_EXISTS 파일이 존재합니다. .It Bq Er FETCH_FULL 파일 시스템의 용량이 부족합니다. .It Bq Er FETCH_INFO 정보로서의 응답입니다. .It Bq Er FETCH_MEMORY 메모리가 부족합니다. .It Bq Er FETCH_MOVED 파일이 이동되었습니다. .It Bq Er FETCH_NETWORK 네트워크 에러 .It Bq Er FETCH_OK 에러는 없습니다. .It Bq Er FETCH_PROTO 프로토콜 에러 .It Bq Er FETCH_RESOLV resolver 에러 .It Bq Er FETCH_SERVER 서버 에러 .It Bq Er FETCH_TEMP 일시적인 에러 .It Bq Er FETCH_TIMEOUT 오퍼레이션이 타임 아웃이 되었습니다. .It Bq Er FETCH_UNAVAIL 파일을 사용할 수 없습니다. .It Bq Er FETCH_UNKNOWN 미지의 에러 .It Bq Er FETCH_URL URL 가 올바르지는 않습니다. .El .Pp 에러 메세지에는, "File is not available (404 Not Found)" 와 같이, 프로토콜의 에러 코드와 메세지가 짜넣어집니다. .Sh 환경 변수 FTP 와 HTTP 에 관련한 함수는, 파일 전송에 사용하는 프록시 서버의 주소로서 .Ev HTTP_PROXY 환경 변수와 .Ev FTP_PROXY 환경 변수를 사용합니다. .Sh 관련 항목 .Xr com_err 3 , .Xr fetch 1 , .Xr ftpio 3 .Rs . %A T. Berners-Lee . %A L. Masinter . %A M. McCahill . %D December 1994 . %T Uniform Resource Locators (URL) . %O RFC1738 .Re .Rs . %A R. Fielding . %A J. Gettys . %A J. Mogul . %A H. Frystyk . %A T. Berners-Lee . %D Januray 1997 . %T Hypertext Transfer Protocol -- HTTP/1. 1 . %O RFC2068 .Re .Rs . %A J. Postel . %A J. K. Reynolds . %D October 1985 . %T File Transfer Protocol . %O RFC959 .Re .Sh 주 .Nm fetch 프로그램 라이브러리는 Common Error 프로그램 라이브러리를 사용하므로, .Nm libfetch 에 링크 하는 어플리케이션은, .Nm libcom_err 에도 링크 할 필요가 있습니다. .Sh 역사 .Nm fetch 프로그램 라이브러리는, .Fx 3.0 에 추가되었습니다. .Sh 저자 .Nm fetch 프로그램 라이브러리는, .An Jordan K. Hubbard Aq jkh@FreeBSD.org , .An Eugene Skepner Aq eu@qub.com , 그 외의 FreeBSD 개발자의 제안을 받아들여 .An Dag-Erling Coidan Smograv Aq des@FreeBSD.org 하지만 작성했습니다. 이것에 의해, .An Poul-Henning Kamp Aq pkh@FreeBSD.org (와)과 .An Jordan K. Hubbard Aq jkh@FreeBSD.org 하지만 작성했다 .Nm ftpio 하지만 옮겨놓을 수 있었습니다. .Pp 이 메뉴얼 페이지의 필자는, .An Dag-Erling Coidan Smograv Aq des@FreeBSD.org 입니다. .Sh 버그 .Fn fetchPutHTTP , .Fn fetchStatHTTP , .Fn fetchListHTTP , .Fn fetchListFTP , FTP 프록시 서포트 등, 프로그램 라이브러리의 일부는 아직 실현되고 있지 않습니다. .Pp .Ev HTTP_PROXY 환경 변수인가 .Ev FTP_PROXY 환경 변수를 적절히 설정하는 이외, 프록시를 실행시에 선택하는 방법은 없습니다. 이 환경 변수를 설정했을 경우는, FTP 함수와 HTTP 함수에 의한 프록시의 사용을 멈출 수 없습니다. .Pp HTTP 인증은 동작하지 않습니다. 조사한 범위에서는, 코드에 버그가 있다고는 단언할 수 없습니다. .Nm libfetch (은)는 HTTP/1. 1 기본 인증을 RFC2068 와 같게 올바르게 처리합니다만, HTTP 서버는, 인증의 헤더 필드를 받아들이지 않습니다. 또 .Nm libfetch (은)는, HTTP 서버의 인증 요구를 해석해 거기에 응답하려고 하지 않습니다. .Pp URL 로 스페이스등을 encode 하는 시도 이야기해지고 있지 않습니다. URL 의 문서 부분의 스페이스는, HTTP URL 로 "%20" 에, FTP URL로 "\\ " 에 옮겨놓을 필요가 있습니다. .Pp 에러 번호는, 특정 문맥만으로 일의입니다. FTP 와 HTTP 로 사용하는 에러 코드, 및 resolver와 시스템의 에러로 사용하는 에러 코드는 중복 합니다. 예를 들어 에러 코드 202 는, FTP에서는 "Command not implemented, superfluous at this site" 를 나타내, HTTP 에서는 "Accepted" 를 나타냅니다. .Pp 이 메뉴얼 페이지는 불충분해, 텍스트의 포맷도 갖추어져 있지 않습니다. .Pp 그 외에도 많은 일이 있습니다.