.\" Copyright (c) 1989, 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. .\" .\" @(#) getfsstat. 2 8.3 (Berkeley) 5/25/95 .\" %FreeBSD: src/lib/libc/sys/getfsstat. 2, v 1.7. 2.4 2001/12/14 18:34:00 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/getfsstat. 2, v 1.5 2001/12/23 00:03:42 horikawa Exp $ .Dd May 25, 1995 .Dt GETFSSTAT 2 .Os .Sh 명칭 .Nm getfsstat .Nd mount 된 모든 파일 시스템의 리스트를 얻는다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/param.h .In sys/ucred.h .In sys/mount.h .Ft int .Fn getfsstat "struct statfs *buf" "long bufsize" "int flags" .Sh 해설 .Fn getfsstat (은)는, mount 된 모든 파일 시스템에 관한 정보를 돌려줍니다. .Fa buf 하 다음과 같이 정의된다 .Xr statfs 구조체에의 포인터입니다. .Bd -literal typedef struct fsid { int32_t val[2]; } fsid_t; /* 파일 시스템 ID 타입 */ /* * 파일 시스템 통계 */ #define MFSNAMELEN 16 /* 파일 시스템의 타입명장, 눌을 포함한다 */ #define MNAMELEN 90 /* 돌려주어진 이름에 대한 버퍼의 길이 */ struct statfs { long f_spare2; /* 플레이스홀더 */ long f_bsize; /* 기본적인 파일 시스템의 블록 사이즈 */ long f_iosize; /* 최적인 전송 블록 사이즈 */ long f_blocks; /* 파일 시스템내의 합계 데이터 블록 */ long f_bfree; /* 파일 시스템내의 미사용의 블록 */ long f_bavail; /* 슈퍼 유저 이외의 유저가 이용할 수 있는 미사용의 블록 */ long f_files; /* 파일 시스템내의 합계 파일 노드 */ long f_ffree; /* 파일 시스템내의 미사용의 파일 노드 */ fsid_t f_fsid; /* 파일 시스템 ID */ uid_t f_owner; /* 파일 시스템을 mount 한 유저 */ int f_type; /* 파일 시스템의 타입 (아래와 같이를 참조) */ int f_flags; /* mount 플래그의 카피 */ long f_spare[2]; /* 후를 위한 margin */ char f_fstypename[MFSNAMELEN];/* 파일 시스템의 타입명 */ char f_mntonname[MNAMELEN];/* mount 된 디렉토리 */ char f_mntfromname[MNAMELEN];/* mount 된 파일 시스템 */ }; .Ed .Pp 돌려주어질 가능성이 있는 플래그에는 다음의 것이 포함됩니다. .Bl -tag -width MNT_ASYNCHRONOUS .It Dv MNT_RDONLY 파일 시스템은 읽기 전용으로서 mount 되고 있습니다. 슈퍼 유저도 기록 할 수 없습니다. .It Dv MNT_NOEXEC 그 파일 시스템상의 파일을 실행할 수 없습니다. .It Dv MNT_NOSUID 실행될 때, 파일의 setuid 비트와 setgid 비트가 효과를 가지지 않습니다. .It Dv MNT_NODEV 파일 시스템내의 특수 파일은 열지 않습니다. .It Dv MNT_SYNCHRONOUS 파일 시스템에의 모든 입출력이 동기적으로 실행됩니다. .It Dv MNT_ASYNCHRONOUS 파일 시스템 입출력이 동기적으로 실행되지 않습니다. .It Dv MNT_LOCAL 로컬에 있는 파일 시스템입니다. .It Dv MNT_QUOTA 파일 시스템상에서 쿼터가 유효하게 되어 있습니다. .It Dv MNT_ROOTFS 루트 파일 시스템인 것을 나타냅니다. .It Dv MNT_EXRDONLY 파일 시스템은 읽기 전용으로 export 되고 있습니다. .It Dv MNT_EXPORTED 파일 시스템은 읽기와 기록의 양쪽 모두에 대해 export 되고 있습니다. .It Dv MNT_DEFEXPORTED 파일 시스템은 어느 인터넷 호스트에도 읽기와 기록의 양쪽 모두에 대해 export 되고 있습니다. .It Dv MNT_EXPORTANON 파일 시스템은 모든 원격 접근을 익명 유저에게 MAP 합니다. .It Dv MNT_EXKERB 파일 시스템은 Kerberos uid 매핑으로 export 되고 있습니다. .El .Pp 특정의 파일 시스템에 대해 미정도리가 되는 필드는 -1 으로 설정됩니다. 버퍼는 .Fa fsstat 구조체의 배열로 묻을 수 있습니다. mount 된 각 파일 시스템에 대해 1 개(살)씩, 최고 .Fa bufsize 그리고 지정된 사이즈까지입니다. .Pp .Fa buf (으)로서 NULL 가 지정되어 있는 경우, .Fn getfsstat (은)는 mount 되고 있는 파일 시스템의 수만을 돌려줍니다. .Pp 통상, .Fa flags 에는 .Dv MNT_WAIT (을)를 지정해야 합니다. .Fa flags (으)로서 .Dv MNT_NOWAIT 하지만 지정되어 있는 경우, .Fn getfsstat (은)는 각 파일 시스템으로부터의 갱신을 요구하지 않고 이용할 수 있는 정보를 돌려줍니다. 그 때문에, 정보가운데는 낡아지고 있는 것이 있겠지만, .Fn getfsstat (은)는 응답할 수 없는 파일 시스템으로부터의 정보를 대기해 블록 할 것은 없습니다. .Sh 반환값 정상적으로 완료하면(자) .Fa fsstat 구조체의 수가 돌려주어집니다. 그렇지 않은 경우는 -1 이 돌려주어져 에러를 나타내기 위해서(때문에) 글로벌 변수 .Va errno 하지만 설정됩니다. .Sh 에러 .Fn getfsstat (은)는 이하의 1 개에서도 진정한 경우, 처리에 실패합니다. .Bl -tag -width Er .It Bq Er EFAULT .Fa buf 하지만 무효인 주소를 가리키고 있습니다. .It Bq Er EIO 파일 시스템을 읽고 쓰기하고 있는 동안에 .Tn I/O (입출력) 에러가 발생했습니다. .El .Sh 관련 항목 .Xr statfs 2 , .Xr fstab 5 , .Xr mount 8 .Sh 역사 .Fn getfsstat 함수는 .Bx 4.4 그리고 처음 등장했습니다.