.\" .\" Copyright (c) 1996 Joerg Wunsch .\" .\" All rights reserved. .\" .\" This program is free software. .\" .\" 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 DEVELOPERS ``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 DEVELOPERS 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/lib/libdisk/libdisk. 3, v 1.11. 2.10 2001/12/17 10:08:29 ru Exp % .\" " .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/libdisk. 3, v 1.4 2002/05/18 07:12:55 horikawa Exp $ .Dd March 15, 1996 .Dt LIBDISK 3 .Os .Sh 명칭 .Nm Open_Disk , .Nm Clone_Disk , .Nm Free_Disk , .Nm Debug_Disk , .Nm Set_Bios_Geom , .Nm Delete_Chunk , .Nm Collapse_Disk , .Nm Collapse_Chunk , .Nm Create_Chunk , .Nm All_FreeBSD , .Nm CheckRules , .Nm Disk_Names , .Nm Set_Boot_Mgr , .Nm Set_Boot_Blocks , .Nm Write_Disk , .Nm Cyl_Aligned , .Nm Next_Cyl_Aligned , .Nm Prev_Cyl_Aligned , .Nm Track_Aligned , .Nm Next_Track_Aligned , .Nm Prev_Track_Aligned , .Nm Create_Chunk_DWIM , .Nm MakeDev , .Nm MakeDevDisk , .Nm ShowChunkFlags , .Nm ChunkCanBeRoot , .Nm chunk_n , .Nm slice_type_name .Nd 슬라이스 및 파티션 label에 대한 인터페이스 프로그램 라이브러리 .Sh 프로그램 라이브러리 .Lb libdisk .Sh 서식 .In sys/types.h .In libdisk.h .Pp .Vt extern const char *chunk_n[] ; .Ft const char * .Fn slice_type_name "int type" "int subtype" .Ft struct disk * .Fn Open_Disk "const char *devname" .Ft struct disk * .Fn Clone_Disk "struct disk *disk" .Ft void .Fn Free_Disk "struct disk *disk" .Ft void .Fn Debug_Disk "struct disk *disk" .Ft void .Fn Set_Bios_Geom "struct disk *disk" "u_long cyl" "u_long heads" "u_long sects" .Ft int .Fn Delete_Chunk "struct disk *disk" "struct chunk *" .Ft void .Fn Collapse_Disk "struct disk *disk" .Ft int .Fn Collapse_Chunk "struct disk *disk" "struct chunk *chunk" .Ft int .Fn Create_Chunk "struct disk *disk" "u_long offset" "u_long size" "chunk_e type" "int subtype" "u_long flags" .Ft void .Fn All_FreeBSD "struct disk *d" "int force_all" .Ft char * .Fn CheckRules "struct disk *" .Ft char ** .Fn Disk_Names "void" .Ft void .Fn Set_Boot_Mgr "struct disk *d" "const u_char *bootmgr" "const size_t bootmgr_size" .Ft int .Fn Set_Boot_Blocks "struct disk *d" "const u_char *boot1" "const u_char *boot2" .Ft int .Fn Write_Disk "struct disk *d" .Ft int .Fn Cyl_Aligned "struct disk *d" "u_long offset" .Ft u_long .Fn Next_Cyl_Aligned "struct disk *d" "u_long offset" .Ft u_long .Fn Prev_Cyl_Aligned "struct disk *d" "u_long offset" .Ft int .Fn Track_Aligned "struct disk *d" "u_long offset" .Ft u_long .Fn Next_Track_Aligned "struct disk *d" "u_long offset" .Ft u_long .Fn Prev_Track_Aligned "struct disk *d" "u_long offset" .Ft struct chunk * .Fn Create_Chunk_DWIM "struct disk *d" "struct chunk *parent" "u_long size" "chunk_e type" "int subtype" "u_long flags" .Ft int .Fn MakeDev "struct chunk *c" "const char *path" .Ft int .Fn MakeDevDisk "struct disk *d" "const char *path" .Ft char * .Fn ShowChunkFlags "struct chunk *c" .Ft char * .Fn ChunkCanBeRoot "struct chunk *c" .Sh 해설 .Nm libdisk (은)는, 저레벨의 디스크 슬라이스 및 파티션 label에 대한 인터페이스를 제공합니다. 대부분의 함수는, .Ql struct disk 또는 .Ql struct chunk 그렇다고 하는 형태의 인수를 취해 동작합니다. .Pp 어느 쪽의 형태도 프로그래머에게는 이해하기 어렵기 때문에, 완전을 기하기 위해서 이하에 내부 구조를 나타냅니다. .Bd -literal -offset indent struct disk { char *name; u_long flags; u_long bios_cyl; u_long bios_hd; u_long bios_sect; u_char *bootmgr; u_char *boot1; u_char *boot2; struct chunk *chunks; u_long sector_size; }; .Ed 함수에 의한 플래그치는 .Ql DISK_ON_TRACK 만으로, 디스크가 On-Track 디스크 매니저에 의해 조작되고 있는 것을 의미합니다. .Pp .Bd -literal -offset indent struct chunk { struct chunk *next; struct chunk *part; struct disk *disk; long offset; u_long size; u_long end; char *name; char *oname; chunk_e type; int subtype; u_long flags; void (*private_free)(void*); void *(*private_clone)(void*); void *private_data; }; .Ed .Ql type 필드는 .Ql whole, unknown, fat, freebsd, extended, part, unused 가운데, 어떤 것인가 하나의 값을 받습니다. .Pp 이하는 .Ql struct chunk 에 두어 .Ql flags 하지만 취할 수 있는 값입니다. .Bl -tag -offset indent -width CHUNK_BSD_COMPATXX .It CHUNK_PAST_1024 실린더 1024 를 넘고 있기 (위해)때문에, 이 area로부터는 부트 할 수 없습니다. .It CHUNK_BSD_COMPAT 이 area는, .Bx 호환이며, .Ql wd0s4f -> wd0f (와)과 같은 단축형도 사용할 수 있습니다. .It CHUNK_ALIGN 이 area는 정합(align)하고 있지 않으면 안됩니다. .It CHUNK_IS_ROOT 이 .Ql part 하 rootfs (이어)여, 파티션을 .Ql a 에 할당합니다. .It CHUNK_ACTIVE MBR 내의 액티브 슬라이스입니다. .It CHUNK_FORCE_ALL 모든 BIOS 에 의한 지오메트리 해석을 무시해, 주어진 디스크 전체를 강제적으로 .Fx 용무로 합니다. .El .Pp 필드 .Ql private_data, `private_free', private_clone (은)는, 어플리케이션 고유의 데이터, 및 그 관리를 위한 물건입니다. 이 기능이 없으면, 기억역의 관리는 하지 못하고, 클로닝에 의해 포인터가 복제되어도 해방할 수 없게 됩니다. .Pp .Fn Open_Disk (은)는, 이름부 디스크를 open 해, 한 무리 (populated)의 트리를 돌려줍니다. .Pp .Fn Clone_Disk (은)는, 트리의 복제를 작성합니다. .Dq Undo 기능에 편리합니다. .Pp .Fn Free_Disk (은)는, .Fn Open_Disk 또는 .Fn Clone_Disk 그리고 작성된 트리를 해방합니다. .Pp .Fn Debug_Disk (은)는, 표준 출력 (stdout) 의 트리의 내용을 출력합니다. .Pp .Fn Set_Bios_Geom (은)는, BIOS 가 사용하는 지오메트리를 설정합니다. .Pp .Fn Delete_Chunk (은)는, disk_space 의 area를 해방합니다. .Pp .Fn Collapse_Disk 및 .Fn Collapse_Chunk (은)는, 아직 시험적인 물건이므로 사용해서는 안됩니다. .Pp .Fn Create_Chunk (은)는, 지정된 파라미터를 가지는 area를 생성합니다. .Pp .Fn All_FreeBSD (은)는, 디스크 전체를 하나의 .Fx 의 area를 작성합니다. .Ql force_all 하지만 설정되어 있으면(자), BIOS 에 의한 지오메트리 해석을 모두 무시합니다. .Pp .Fn CheckRules (은)는, 이 디스크 레이아웃이 모순된 구획 규칙에 대한 경고를 캐릭터 라인 .Ql char* (으)로서 돌려줍니다. .Pp .Fn Disk_Names (은)는, 모든 디스크명 (wd0, wd1 ...)(을)를 격납한 캐릭터 라인군 .Ql char** (을)를 돌려줍니다. 배열과 같이, 각 포인터를 수동으로 해방하지 않으면 안됩니다. .Pp .Fn Set_Boot_Mgr (은)는, 이 부트 매니저를 디스크상에서 사용하도록(듯이) 설정합니다. .Fn Write_Disk 하지만 불려 갈 때 기입해진 것을 취득합니다. .Pp .Fn Set_Boot_Blocks (은)는, 디스크상에서 사용되는 부트 블록을 설정합니다. .Fn Write_Disk 하지만 불려 갈 때 기입해진 것을 취득합니다. .Pp .Fn Write_Disk (은)는, MBR , 디스크 label, 부트 블록, 부트 매니저 모든 것을 기입합니다. .Pp .Fn Cyl_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset 하지만 실린더상에 정합하고 있는지 어떤지를 조사합니다. .Pp .Fn Next_Cyl_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset (을)를 다음의 실린더에 끝맺어 배치합니다. .Pp .Fn Prev_Cyl_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset (을)를 전의 실린더에 인하해 배치합니다. .Pp .Fn Track_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset 하지만 트럭상에 배치되고 있는지 어떤지를 조사합니다. .Pp .Fn Next_Track_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset (을)를 다음의 트럭에 끝맺어 배치합니다. .Pp .Fn Prev_Track_Aligned (은)는, BIOS 지오메트리에 따라 .Ql offset 하지만 트럭상에 배치되고 있는지 어떤지를 조사합니다. .Pp .Fn Create_Chunk_DWIM (은)는, 지정된 친영역내로 지정 사이즈의 파티션을 생성해, 그 포인터를 돌려줍니다. 최초로 발견된 충분한 크기의 미사용 area가 사용됩니다. .Pp .Fn MakeDev (은)는, 이 area의 디바이스 노드를 작성합니다. .Pp .Fn MakeDevDisk (은)는, 디스크상에 있는 모든 area의 디바이스 노드를 작성합니다. .Pp .Fn ShowChunkFlags (은)는, 플래그를 표시하는 캐릭터 라인을 돌려줍니다. .Pp .Fn ChunkCanBeRoot (은)는, area가 .Ql / (이)가 될 수 있다면 눌을 돌려줍니다. .Pp area명을 나타내는 캐릭터 라인은, 외부 배열 변수 .Va chunk_n (을)를 사용해 직접 액세스 할 수 있습니다. .Pp .Fn slice_type_name (은)는, 지정되었다 .Ql type . .Ql subtype 에 관련 지을 수 있었던 이름 캐릭터 라인을 돌려줍니다. .Fn slice_type_name 하지만 슬라이스에 대해서 "unknown" 를 돌려주는 것은, 미지의 경우, 즉 .Ql / 입니다. .Pp .Sh 저자 .An -nosplit .Nm libdisk (은)는, .An Poul-Henning Kamp 하지만 작성했습니다. .Pp 이 메뉴얼 페이지의 집필자는 .An J\(:org Wunsch 입니다.