statfs.2 (108028) | statfs.2 (108087) |
---|---|
1.\" Copyright (c) 1989, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)statfs.2 8.5 (Berkeley) 5/24/95 | 1.\" Copyright (c) 1989, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)statfs.2 8.5 (Berkeley) 5/24/95 |
33.\" $FreeBSD: head/lib/libc/sys/statfs.2 108028 2002-12-18 09:22:32Z ru $ | 33.\" $FreeBSD: head/lib/libc/sys/statfs.2 108087 2002-12-19 09:40:28Z ru $ |
34.\" 35.Dd May 24, 1995 36.Dt STATFS 2 37.Os 38.Sh NAME 39.Nm statfs 40.Nd get file system statistics 41.Sh LIBRARY --- 5 unchanged lines hidden (view full) --- 47.Fn statfs "const char *path" "struct statfs *buf" 48.Ft int 49.Fn fstatfs "int fd" "struct statfs *buf" 50.Sh DESCRIPTION 51The 52.Fn statfs 53system call 54returns information about a mounted file system. | 34.\" 35.Dd May 24, 1995 36.Dt STATFS 2 37.Os 38.Sh NAME 39.Nm statfs 40.Nd get file system statistics 41.Sh LIBRARY --- 5 unchanged lines hidden (view full) --- 47.Fn statfs "const char *path" "struct statfs *buf" 48.Ft int 49.Fn fstatfs "int fd" "struct statfs *buf" 50.Sh DESCRIPTION 51The 52.Fn statfs 53system call 54returns information about a mounted file system. |
55.Fa Path | 55The 56.Fa path 57argument |
56is the path name of any file within the mounted file system. | 58is the path name of any file within the mounted file system. |
57.Fa Buf | 59The 60.Fa buf 61argument |
58is a pointer to a | 62is a pointer to a |
59.Fn statfs | 63.Vt statfs |
60structure defined as follows: 61.Bd -literal 62typedef struct fsid { int32_t val[2]; } fsid_t; /* file system id type */ 63 64/* 65 * file system statistics 66 */ 67 --- 65 unchanged lines hidden (view full) --- 133.Sh ERRORS 134The 135.Fn statfs 136system call 137fails if one or more of the following are true: 138.Bl -tag -width Er 139.It Bq Er ENOTDIR 140A component of the path prefix of | 64structure defined as follows: 65.Bd -literal 66typedef struct fsid { int32_t val[2]; } fsid_t; /* file system id type */ 67 68/* 69 * file system statistics 70 */ 71 --- 65 unchanged lines hidden (view full) --- 137.Sh ERRORS 138The 139.Fn statfs 140system call 141fails if one or more of the following are true: 142.Bl -tag -width Er 143.It Bq Er ENOTDIR 144A component of the path prefix of |
141.Fa Path | 145.Fa path |
142is not a directory. 143.It Bq Er ENAMETOOLONG 144The length of a component of 145.Fa path 146exceeds 255 characters, 147or the length of 148.Fa path 149exceeds 1023 characters. 150.It Bq Er ENOENT 151The file referred to by 152.Fa path 153does not exist. 154.It Bq Er EACCES 155Search permission is denied for a component of the path prefix of 156.Fa path . 157.It Bq Er ELOOP 158Too many symbolic links were encountered in translating 159.Fa path . 160.It Bq Er EFAULT | 146is not a directory. 147.It Bq Er ENAMETOOLONG 148The length of a component of 149.Fa path 150exceeds 255 characters, 151or the length of 152.Fa path 153exceeds 1023 characters. 154.It Bq Er ENOENT 155The file referred to by 156.Fa path 157does not exist. 158.It Bq Er EACCES 159Search permission is denied for a component of the path prefix of 160.Fa path . 161.It Bq Er ELOOP 162Too many symbolic links were encountered in translating 163.Fa path . 164.It Bq Er EFAULT |
161.Fa Buf | 165The 166.Fa buf |
162or 163.Fa path | 167or 168.Fa path |
169argument |
|
164points to an invalid address. 165.It Bq Er EIO 166An 167.Tn I/O 168error occurred while reading from or writing to the file system. 169.El 170.Pp 171The 172.Fn fstatfs 173system call 174fails if one or more of the following are true: 175.Bl -tag -width Er 176.It Bq Er EBADF | 170points to an invalid address. 171.It Bq Er EIO 172An 173.Tn I/O 174error occurred while reading from or writing to the file system. 175.El 176.Pp 177The 178.Fn fstatfs 179system call 180fails if one or more of the following are true: 181.Bl -tag -width Er 182.It Bq Er EBADF |
183The |
|
177.Fa fd | 184.Fa fd |
185argument |
|
178is not a valid open file descriptor. 179.It Bq Er EFAULT | 186is not a valid open file descriptor. 187.It Bq Er EFAULT |
180.Fa Buf | 188The 189.Fa buf 190argument |
181points to an invalid address. 182.It Bq Er EIO 183An 184.Tn I/O 185error occurred while reading from or writing to the file system. 186.El 187.Sh HISTORY 188The 189.Fn statfs 190system call first appeared in 191.Bx 4.4 . | 191points to an invalid address. 192.It Bq Er EIO 193An 194.Tn I/O 195error occurred while reading from or writing to the file system. 196.El 197.Sh HISTORY 198The 199.Fn statfs 200system call first appeared in 201.Bx 4.4 . |