usr/src/man/man7fs/bootfs.7fs

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright (c) 2014 Joyent, Inc.  All rights reserved.
  13 .\"
  14
  15 .TH BOOTFS 7FS "May 8, 2014"
  16 .SH NAME
  17 bootfs \- boot-time module file system
  18
  19 .SH DESCRIPTION
  20
  21 The
  22 .B bootfs
  23 file system is a read-only file system that provides access to any
  24 boot-time modules that were passed in to the system loader which were
  25 tagged with the type
  26 .IR file .
  27 .B bootfs
  28 does not display any boot-time modules that were tagged as type
  29 .I hash
  30 or type
  31 .IR rootfs .
  32
  33 If modules with duplicate names and paths are specified, only the first
  34 such entry will be present in the file system and a counter will be
  35 incremented to indicate that a duplicate entry was found, but is not
  36 present into the file system. If a module's name only consists of
  37 invalid characters, such as '.', '..', or '/', then the module will not
  38 be present in the file system and a counter will be incremented to
  39 indicate that this has occurred. In both cases, diagnostic information
  40 is available through the kstats facility.
  41
  42 .SH FILES
  43 .ne 2
  44 .na
  45 .B /system/boot
  46 .ad
  47 .RS 8n
  48 The mount point for the
  49 .B bootfs
  50 file system in the global zone.
  51
  52 .SH EXAMPLES
  53
  54 .LP
  55 Example 1 Determining if collisions or invalid names are present
  56 .sp
  57 .LP
  58 To determine if any boot-time modules were not created due to collisions
  59 or invalid names, enter the following command:
  60
  61 .sp
  62 .in +2
  63 .nf
  64 # kstat -m bootfs
  65 module: bootfs                          instance: 1
  66 name:   bootfs                          class:    fs
  67         crtime                          236063.651324041
  68         nbytes                          8749355
  69         ndirs                           3
  70         ndiscard                        0
  71         ndup                            0
  72         nfiles                          2
  73         snaptime                        236063.651324041
  74 .fi
  75 .in -2
  76 .sp
  77 .LP
  78 The field
  79 .B ndiscard
  80 lists the number of boot-time modules that were discarded due to naming conflicts. The field
  81 .B ndup
  82 lists the number of duplicate entries that were found and therefore not displayed in the file system.
  83 .sp
  84 .LP
  85 This information is provided for informational purposes only, it is not to be construed as a stable interface.
  86
  87 .SH SEE ALSO
  88 .BR kstat (1M),
  89 .BR grub (5)