.\" $FreeBSD: doc/ja_JP.eucJP/man/man5/pccard.conf. 5, v 1.12 2002/04/28 22:05:39 horikawa Exp $ .\" .\" Copyright (c) 1994 Andrew McRae. 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. The name of the author may not be used to endorse or promote products .\" derived from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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. .\" .\" %FreeBSD: src/usr.sbin/pccard/pccardd/pccard.conf. 5, v 1.12. 2.10 2002/04/07 04:57:14 dd Exp % .\" .\" WORD: resource 리소스[pccard.conf. 5] .\" .Dd November 2, 1994 .Dt PCCARD.CONF 5 .Os .Sh 명칭 .Nm pccard.conf .Nd .Xr pccardd 8 설정 파일 .Sh 해설 .Nm pccard.conf 파일은, PC-CARD 슬롯 관리 demon .Xr pccardd 8 용무의 설정 파일입니다. 카드를 식별해, PC-CARD 카드로 드라이버 (드라이버용 리소스도 포함한다)를 대응시킬 수가 있는 정보를 제공합니다. .Pp 설정 파일내에는 네 개의 기본적인 요소가 있습니다. 옵션으로서 다른 섹션에 앞서 .Em "리소스 풀" (이)가 있어, 그 후 1 개(살) 이상의 .Em "카드 식별자" (와)과 .Em "디바이스 실체" 하지만 계속됩니다. 마지막 2 개(살)은 어떤 순서로 나타나도 자주(잘), 형편에 응해 여기저기에 산재 해도 상관하지 않습니다. .Pp .Pa /etc/pccard.conf 파일은, 디폴트의 리소스 풀 설정과 pccard 식별자 데이타베이스를 가진다 .Pa /etc/defaults/pccard.conf (으)로부터 인클루드 됩니다. 유저 고유의 설정을 .Pa /etc/pccard.conf 그리고 지정해, 이러한 디폴트를 덧쓰기하거나 추가 엔트리를 추가 가능합니다. .Pp 각각의 PC-CARD 카드는, 제조자나 카드의 버젼을 규정한다 설정 타풀을 포함하고 있습니다. 이것들은, 설정 파일중에서 카드의 사양을 특정하는데 사용되어 거기에 따라, 그 카드와 인터페이스를 취할 수 있다 드라이버를 찾아냅니다. 카드와 드라이버의 사이에는, 다대 1 의 대응 관계가 있습니다. 즉, 단일의 드라이버가 복수의 형태의 카드로 인터페이스를 취하는 일이 있습니다. 이 돕고로서 드라이버의 지정과는 별도로, 카드의 초기화나 (네트워크 카드의 경우라면) 이더넷 어드레스의 취득용으로 파라미터를 지정할 수도 있습니다. .Pp 드라이버는 한 번 카드로 할당할 수 있으면(자), 그 카드로 할당할 수 있었다 가 됩니다. 그러나, 같은 형태의 드라이버의 복수의 실체가 설정된다 일도 있기 (위해)때문에, 만약, 같은의 형태의 드라이버가 대응 지을 수 있고 있는 카드가 2 매 꽂으면(자) , 같은 이름으로 다른 드라이버 실체가 설정될 가능성이 있습니다. .Pp .Em insert (와)과 .Em remove 명령은, 실행 가능한 쉘 커멘드행을 지정할 수가 있습니다. 실행되는 명령은, 그 키워드의 뒤의 행의 나머지입니다. 행은, backslash를 사용해 계속할 수가 있습니다. 간단한 매크로 치환에 의해, 현재의 커널의 디바이스명 .Em ( $device ) (와)과 네트워크 카드의 이더넷 어드레스 .Em ( $ether ) (을)를 명령행에 넣는 것이 가능합니다. .Xr pccardd 8 (은)는, 명령행을 실행하기 위해서 .Xr system 3 써브루틴을 사용합니다. .Pp .Xr pccardd 8 (은)는, syslog 를 사용해, 카드의 삽발을 아나운스 합니다. .Em logstr 명령로 설정된 캐릭터 라인을 사용하는지, 이것이 설정되어 있지 않은 경우에는, 제조자와 카드 버젼의 캐릭터 라인을 사용합니다. .Pp 수치는 8 진수, 16 진수, 10 진수의 몇개의 표현을 취합니다. 만약 10 진수에 .Em k 인가 .Em K 하지만 붙어 있으면, 그 값은 1024 를 건 것이 됩니다. 이름에 스페이스를 포함할 필요가 있다면, 더블 쿼트로 괄은 두면(자) 좋을 것입니다. 해시 캐릭터 (#)는, 그 행의 나머지를 코멘트로 합니다. .Ss "리소스 풀" 이 (옵션이다) 섹션은, ISA 버스의 메모리아드레스 공간이나 I/O 포트, 새치기 요구 번호 (IRQ)라고 하는 system resource의 풀을 지정합니다. 이 리소스 풀은, 각각의 드라이버의 기술중에서 지정된 요구에 응해, 동적으로 address 공간이나 끼어들어 번호를 할당하는데 사용됩니다. .Pp 리소스에 관한 구문은 이하와 같습니다. .Pp .Dl io Ar start - end ... .Dl memory Ar address size ... .Dl irq Ar irq-number ... .Pp 각 문에서는, 초기화시에 드라이버에 할당하는데 사용할 수 있는, I/O 나 메모리나 IRQ 의 블록을 정의합니다. .Pp 디버그 레벨 파라미터의 문법은 다음과 같습니다: .Pp .Dl debuglevel Ar level .Pp 위의 문장은 모두 복수행으로 할 수가 있어 이것으로 각각의 리소스를 덩어리로 나누어 정의할 수가 있습니다. .Ss "카드 식별자" 카드 식별자의 구문은 이하와 같습니다. .Pp .Dl card Ar manufacturer version [ add_info1 [ add_info2 ]] .Dl config Ar index driver interrupt [ flags ] .Dl ether Ar offset .Dl reset Ar time .Dl iosize Ar size .Dl memsize Ar size .Dl insert Ar command .Dl remove Ar command .Dl logstr Ar string .Pp 제 1 행은 필수입니다. 그리고의 문장은 옵션이며, 어떠한 순서로 나타나도 상관하지 않습니다. .Em config 행은 복수 존재하는 일도 있습니다. .Em card 의 파라미터에는, 제조자명, 카드의 버젼, 그리고 추가 정보 add_info1 와 add_info2 가 있어, 카드의 CIS 메모리로부터 얻은 값과의 일치를 보는데 사용됩니다. \&"/. */" (와)과 같이 '/'로 캐릭터 라인을 죄어든 곳, 이러한 파라미터는, 확장 정규 표현 .Xr regex 3 그리고 기술 가능합니다. 각 식은, 선두에 있어 캐릭터 '^'로 평가됩니다. .Pp .Em config 파라미터는, 카드의 CIS 로 얻을 수 있는 범위로부터 그 카드의 설정 인덱스를 선택해, 이 설정으로 관련 지을 수 있었던 드라이버를 선택해, 그리고 (만약 있으면) 할당할 수 있어야 할 세치기 레벨을 선택합니다. 옵션으로서 플래그의 집합을 할당할 수도 있습니다. .Ar index 그럼, ``auto''또는 ``default''인가, 카드의 CIS 로부터 취득 가능한 취득 가능한 범위를 지정합니다. ``auto''에 의해, CIS 로부터 취득되는 정보와 사용중의 I/O 리소스 상태로부터, 자동적으로 리소스를 할당하고 가능합니다. .Pp 옵션의 .Em ether 키워드는, 카드의 속성 메모리내에 네트워크 카드의 물리 이더넷 어드레스가 보관 유지되고 있을 때 사용됩니다. 이 문장의 파라미터는, 이더넷 어드레스의 속성 메모리내에서의 오프셋(offset)를 가리키고 있습니다. 이 값은, .Em $ether 매크로를 사용하는 것으로, insert/remove 명령내에서도 사용할 수 있습니다. .Pp 옵션의 .Em reset 키워드는, 카드 삽입시의 리셋트 기간을 .Ar time 밀리 세컨드이라고 지정합니다. 디폴트는 100 밀리 세컨드입니다. .Pp .Em iosize (와)과 .Em memsize 의 키워드는, I/O 포트나 공유 메모리브록크등의 리소스가 CIS 타풀로 지정되어 있지 않다 카드용으로 사용합니다. .Pp .Em insert 및 .Em remove 섹션에서는, 카드가 삽입되거나 떼어내지거나 했을 때에 실행되어야 할 쉘 명령을 쓸 수가 있습니다. 복수의 .Em insert (이)나 .Em remove 명령도 쓸 수가 있어 그 경우 열거된 순서에 실행됩니다. .Pp .Em logstr 명령로, 카드삽발시에 로그 되는 캐릭터 라인을, 유저가 지정 가능합니다. .Em logstr 하지만 지정되어 있지 않은 경우, CIS 중의 제조자와 카드 버젼의 캐릭터 라인을 사용해, 출력 캐릭터 라인을 생성합니다. .Ss 와일드 카드 엔트리 다음의, 카드 식별자의 2 개의 와일드 카드 엔트리는, 범용 카드로 사용 가능합니다: .Pp .Dl generic serial .Dl generic fixed_disk .Pp 키워드 .Em serial (은)는 ``Functional ID: Serial port/modem''에 매치 해, .Em fixed_disk (은)는 ``Fixed disk card'에 매치 합니다. 구문은 .Em "card identifiers" (와)과 같습니다만, 최초의 행으로 ``card''대신에 ``generic''가 사용됩니다. 이것들은, .Nm 의 마지막에 놓여져 다른 .Em card 엔트리에 매치 하지 않았던 카드가 다음에 이것들에 성냥 할 수 있도록(듯이) 합니다. 역사적인 사정으로, 앨리어스(alias) ``function''를 ``generic''대신에 사용 가능합니다. .Sh 사용예 전형적인 설정 파일은 이하와 같은 체재지요. .Bd -literal # # 샘플 설정 파일 # # 파라미터의 풀 # io 0x280 - 0x2F0 0x300 - 0x360 irq 5 6 8 9 10 15 memory 0xd4000 96k memory 0xc4000 32k # # 카드 데이타베이스 # card "RPTI LTD. " "EP400" # NE2000 clone ether 0x110 config 0x21 "ed0" 5 insert ifconfig $device physical $ether insert ifconfig $device bean remove ifconfig $device down card "XYZZY" "FAX/1. 0" tty config 0x30 "sio1" 11 insert echo start getty remove echo stop getty .Ed .Sh 관련 파일 .Bl -tag -width /etc/defaults/pccard.conf -compact .It Pa /etc/defaults/pccard.conf .Xr pccardd 8 의 설정 파일. .It Pa /etc/pccard.conf 유저의 설정 파일. .El .Sh 관련 항목 .Xr pccardd 8