xref: /illumos-gate/usr/src/man/man4fs/objfs.4fs (revision bbf215553c7233fbab8a0afdf1fac74c44781867)
1*bbf21555SRichard Lowe.\"
2*bbf21555SRichard Lowe.\" Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
3*bbf21555SRichard Lowe.\" Copyright 2021 Oxide Computer Company
4*bbf21555SRichard Lowe.\"
5*bbf21555SRichard Lowe.\" The contents of this file are subject to the terms of the
6*bbf21555SRichard Lowe.\" Common Development and Distribution License (the "License").
7*bbf21555SRichard Lowe.\" You may not use this file except in compliance with the License.
8*bbf21555SRichard Lowe.\"
9*bbf21555SRichard Lowe.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*bbf21555SRichard Lowe.\" or http://www.opensolaris.org/os/licensing.
11*bbf21555SRichard Lowe.\" See the License for the specific language governing permissions
12*bbf21555SRichard Lowe.\" and limitations under the License.
13*bbf21555SRichard Lowe.\"
14*bbf21555SRichard Lowe.\" When distributing Covered Code, include this CDDL HEADER in each
15*bbf21555SRichard Lowe.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*bbf21555SRichard Lowe.\" If applicable, add the following below this CDDL HEADER, with the
17*bbf21555SRichard Lowe.\" fields enclosed by brackets "[]" replaced with your own identifying
18*bbf21555SRichard Lowe.\" information: Portions Copyright [yyyy] [name of copyright owner]
19*bbf21555SRichard Lowe.\"
20*bbf21555SRichard Lowe.Dd November 29, 2021
21*bbf21555SRichard Lowe.Dt OBJFS 4FS
22*bbf21555SRichard Lowe.Os
23*bbf21555SRichard Lowe.Sh NAME
24*bbf21555SRichard Lowe.Nm objfs
25*bbf21555SRichard Lowe.Nd Kernel object filesystem
26*bbf21555SRichard Lowe.Sh DESCRIPTION
27*bbf21555SRichard LoweThe
28*bbf21555SRichard Lowe.Nm
29*bbf21555SRichard Lowefilesystem describes the state of all modules currently loaded
30*bbf21555SRichard Loweby the kernel.
31*bbf21555SRichard LoweIt is mounted during boot at
32*bbf21555SRichard Lowe.Pa /system/object .
33*bbf21555SRichard Lowe.Pp
34*bbf21555SRichard LoweThe contents of the filesystem are dynamic and reflect the current state of the
35*bbf21555SRichard Lowesystem.
36*bbf21555SRichard LoweEach module is represented by a directory containing a single file,
37*bbf21555SRichard Lowe.Sq object' .
38*bbf21555SRichard LoweThe object file is a read only ELF file which contains information about the
39*bbf21555SRichard Loweobject loaded in the kernel.
40*bbf21555SRichard Lowe.Pp
41*bbf21555SRichard LoweThe kernel may load and unload modules dynamically as the system runs.
42*bbf21555SRichard LoweAs a result, applications may observe different directory contents in
43*bbf21555SRichard Lowe.Pa /system/object
44*bbf21555SRichard Loweif they repeatedly rescan the directory.
45*bbf21555SRichard LoweIf a module is unloaded, its associated
46*bbf21555SRichard Lowe.Pa /system/object
47*bbf21555SRichard Lowefiles disappear from the hierarchy and subsequent attempts to open them, or to
48*bbf21555SRichard Loweread files opened before the module unloaded, elicits an error.
49*bbf21555SRichard Lowe.Pp
50*bbf21555SRichard LoweThis file system is generally not present in a non-global zone.
51*bbf21555SRichard Lowe.Sh FILES
52*bbf21555SRichard Lowe.Bl -tag -width Pa
53*bbf21555SRichard Lowe.It Pa /system/object
54*bbf21555SRichard LoweMount point for objfs file system in the global zone.
55*bbf21555SRichard Lowe.El
56*bbf21555SRichard Lowe.Sh Interface Stability
57*bbf21555SRichard Lowe.Sy Private
58*bbf21555SRichard Lowe.Sh SEE ALSO
59*bbf21555SRichard Lowe.Xr vfstab 5
60*bbf21555SRichard Lowe.Sh NOTES
61*bbf21555SRichard LoweThe content of the ELF files is private to the implementation and subject to
62*bbf21555SRichard Lowechange without notice.
63