.\" %FreeBSD: src/lib/libc/gen/getvfsent. 3, v 1.17. 2.5 2001/12/14 18:33:51 ru Exp % .\" Written by Garrett A. Wollman, September 1994. .\" This manual page is in the public domain. .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/getvfsent. 3, v 1.6 2002/11/03 06:38:28 horikawa Exp $ .Dd September 24, 1994 .Dt GETVFSENT 3 .Os .Sh 명칭 .Nm getvfsent , .Nm setvfsent , .Nm endvfsent , .Nm vfsisloadable , .Nm vfsload .Nd 가상 파일 시스템 모듈을 관리 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/param.h .In sys/mount.h .Ft struct ovfsconf * .Fn getvfsent "void" .Ft void .Fn setvfsent "int cachelist" .Ft void .Fn endvfsent "void" .Ft int .Fn vfsisloadable "const char *name" .Ft int .Fn vfsload "const char *name" .Sh 해설 .Fn getvfsent 함수에 의해, 커널이 관리하는 인스톨제의 가상 파일 시스템 모듈 의 리스트에, 간단하게 액세스 할 수 있습니다. 리스트의 파일 시스템을 1 회에 1 개(살)씩 단계적으로 처리합니다. 이용할 수 있는 데이터가 그 이상 없어지면(자), 눌 포인터가 돌아갑니다. 구조체 .Dq Li struct ovfsconf 의 필드는 다음과 같습니다. .Pp .Bl -tag -compact -width vfc_refcount .It vfc_name 파일 시스템의 이름. .It vfc_index 커널에 의해 할당 .Xr mount 2 의 호출에 사용된, 파일 시스템의 타입 번호. .It vfc_refcount 이 파일 시스템의 참조수 (통상은 mount수입니다만, 언로드할 수 없는가 커널에 정적으로 링크 되고 있다 파일 시스템에서는, mount수에 1 을 더한 것이 됩니다). .It vfc_flags flag bit. .El .Pp 플래그는 다음과 같이 정의되고 있습니다: .Pp .Bl -tag -width VFCF_SYNTHETIC -compact .It Dv VFCF_STATIC 커널에 정적으로 짜넣어지고 있다 .It Dv VFCF_NETWORK 데이터를 네트워크 경유로 취득 할 수 있다 .It Dv VFCF_READONLY 기입은 미실장 .It Dv VFCF_SYNTHETIC 데이터는 열매 파일을 표현하지 않는다 .It Dv VFCF_LOOPBACK mount 끝난 파일 시스템에 대한 별명 .It Dv VFCF_UNICODE 파일명을 Unicode 로 격납 .El .Pp .Fn setvfsent 및 .Fn endvfsent 함수는, .Xr sysctl 3 (이)가 따라 커널 (으)로부터 정리해 취득되는 파일 시스템 리스트의, 캐싱 제어에 사용됩니다. .Fn setvfsent 의 .Fa cachelist 파라미터가 0 이 아니면, 이것들 검색 함수의 어떤 것인지를 최초로 호출한 시점에서 리스트는 다만 1 회만 꺼내져 캐쉬를 클리어 하기 위해서 .Fn endvfsent 하지만 불려 갈 때까지 보관 유지됩니다. 일반적으로 .Fn setvfsent 1 (은)는, .Fn getvfsent (을)를 사용하는 프로그램에 의해 불려 갈 필요가 있어, .Fn setvfsent 0 하 (이것도 디폴트 상태로), .Fn vfsload 함수를 사용하는 프로그램에 의해 불려 갈 필요가 있습니다. .Pp .Fn vfsisloadable 함수는, 다음에 .Fn vfsload name 의 호출이 계속될 것 같다면 비 0 치를 돌려줍니다. 여기서 .Dq 그렇게 이렇게 말하는 것은, .Fn vfsisloadable 하 .Fn vfsload 하지만 성공하기 위한 조건을 체크하지 않기 때문입니다. .Pp .Fn vfsload 함수는, 파일 시스템 .Fa name 의 실장 커널 모듈을 로드 하려고 시도합니다. 파일 시스템 모듈을 무사하게 밝혀내 로드했다 경우는 0 이, 그 외의 경우는 비 0 이 돌아갑니다. 이 함수를 호출할 수 있는 것은 다음에 가리키는 상황만입니다. .Bl -enum .It .Fn getvfsbyname (을)를 호출해 비 0 치가 돌아갔을 경우. .It .Fn vfsisloadable (을)를 호출해 비 0 치가 돌아갔을 경우. .El .Pp .Xr mount_cd9660 8 의 소스로부터 배달시킨 사용예를 다음에 나타냅니다. .Bd -literal -offset indent struct vfsconf *vfc; int error; /* 여기에 셋업 코드가 들어간다 */ error = getvfsbyname("cd9660", &vfc); if (error && vfsisloadable("cd9660")) { if (vfsload("cd9660")) err(EX_OSERR, "vfsload(cd9660)"); endvfsent(); /* flush cache */ error = getvfsbyname("cd9660", &vfc); } if (error) errx(1, "cd9660 filesystem is not available"); if (mount(vfc.vfc_name, dir, mntflags, &args) < 0) err(1, NULL); .Ed .Sh 반환값 .Fn getvfsent routine는, 성공하면(자) 정적 데이터 구조체의 포인터를, 실패하면(자) 눌 포인터를 돌려줍니다. 원인이 .Xr sysctl 3 또는 .Xr malloc 3 그리고 실패했을 경우는, .Va errno 하지만 그것들 함수용으로 문서 된 값의 1 개(살)에 설정되는 일이 있습니다. 그 외의 경우 .Va errno (은)는 개편되지 않습니다. .Pp .Fn vfsload 함수는 실패하면(자) 비 0 치를, 성공하면(자) 0 을 돌려줍니다. .Fn vfsload 하지만 실패했을 경우, .Xr kldload 2 용으로 기술되었다 .Va errno 값이 설정될 수 있습니다. .Sh 관련 항목 .Xr kldload 2 , .Xr mount 2 , .Xr mount 8 .Sh 저자 .An -nosplit 이 로드 가능 파일 시스템 서포트는, .An Terry Lambert 에 의한 범용의 로드 가능 커널 모듈 서포트를 베이스로, .An Garrett A. Wollman 에 의해 쓰여졌습니다. .Sh 역사 .Fn getvfsent 함수 패밀리는 .Fx 2.0 그리고 처음 등장했습니다.