getvfsbyname.3 (32eef9aeb1f39a1623cea55da147c89abbd5b9a5) getvfsbyname.3 (5965373e69ca208cedd8ede9716ef0d58e6c3434)
1.\" Copyright (c) 1995
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.

--- 30 unchanged lines hidden (view full) ---

39.Nm getvfsbyname
40.Nd get information about a filesystem
41.Sh LIBRARY
42.Lb libc
43.Sh SYNOPSIS
44.In sys/param.h
45.In sys/mount.h
46.Ft int
1.\" Copyright (c) 1995
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.

--- 30 unchanged lines hidden (view full) ---

39.Nm getvfsbyname
40.Nd get information about a filesystem
41.Sh LIBRARY
42.Lb libc
43.Sh SYNOPSIS
44.In sys/param.h
45.In sys/mount.h
46.Ft int
47.Fn getvfsbyname "const char *name" "struct vfsconf *vfc"
47.Fn getvfsbyname "const char *name" "struct xvfsconf *vfc"
48.Sh DESCRIPTION
49The
50.Fn getvfsbyname
51function provides access to information about a
52filesystem module that is configured in the kernel.
53If successful,
54the requested filesystem
48.Sh DESCRIPTION
49The
50.Fn getvfsbyname
51function provides access to information about a
52filesystem module that is configured in the kernel.
53If successful,
54the requested filesystem
55.Fa vfsconf
55.Fa xvfsconf
56is returned in the location pointed to by
57.Fa vfc .
58The fields in a
56is returned in the location pointed to by
57.Fa vfc .
58The fields in a
59.Dq Li struct vfsconf
59.Dq Li struct xvfsconf
60are defined as follows:
61.Pp
62.Bl -tag -compact -width vfc_refcount
63.It vfc_name
64the name of the filesystem
65.It vfc_typenum
66the filesystem type number assigned by the kernel
67.It vfc_refcount
68the number of active mount points using the filesystem
69.It vfc_flags
60are defined as follows:
61.Pp
62.Bl -tag -compact -width vfc_refcount
63.It vfc_name
64the name of the filesystem
65.It vfc_typenum
66the filesystem type number assigned by the kernel
67.It vfc_refcount
68the number of active mount points using the filesystem
69.It vfc_flags
70flag bits as described in
71.Xr getvfsent 3
70flag bits, as described below
72.El
71.El
72.Pp
73The flags are defined as follows:
74.Pp
75.Bl -tag -width VFCF_SYNTHETIC -compact
76.It Dv VFCF_STATIC
77statically compiled into kernel
78.It Dv VFCF_NETWORK
79may get data over the network
80.It Dv VFCF_READONLY
81writes are not implemented
82.It Dv VFCF_SYNTHETIC
83data does not represent real files
84.It Dv VFCF_LOOPBACK
85aliases some other mounted FS
86.It Dv VFCF_UNICODE
87stores file names as Unicode
88.El
73.Sh RETURN VALUES
74.Rv -std getvfsbyname
75.Sh ERRORS
76The following errors may be reported:
77.Bl -tag -width Er
78.It Bq Er EFAULT
79The
80.Fa vfc
81pointer contains an invalid address.
82.It Bq Er ENOENT
83The
84.Fa name
85specifies a filesystem that is unknown or not configured in the kernel.
86.El
87.Sh SEE ALSO
88.Xr mount 2 ,
89.Sh RETURN VALUES
90.Rv -std getvfsbyname
91.Sh ERRORS
92The following errors may be reported:
93.Bl -tag -width Er
94.It Bq Er EFAULT
95The
96.Fa vfc
97pointer contains an invalid address.
98.It Bq Er ENOENT
99The
100.Fa name
101specifies a filesystem that is unknown or not configured in the kernel.
102.El
103.Sh SEE ALSO
104.Xr mount 2 ,
89.Xr getvfsent 3 ,
90.Xr sysctl 3 ,
91.Xr mount 8 ,
92.Xr sysctl 8
93.Sh HISTORY
94A variant of the
95.Fn getvfsbyname
96function first appeared in
97.Fx 2.0 .
105.Xr sysctl 3 ,
106.Xr mount 8 ,
107.Xr sysctl 8
108.Sh HISTORY
109A variant of the
110.Fn getvfsbyname
111function first appeared in
112.Fx 2.0 .