Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
The lofi file driver exports a file as a block device, enabling system utilities such as fstyp(1M), fsck(1M) and mount(1M) to operate on underlying file system images (including CD-ROM and FAT floppy images) contained on the block device. Reads and writes to the block device are translated to reads and writes on the exported file. See lofiadm(1M) for examples.
File block device entries are contained in /dev/lofi. The /dev/rlofi file contains the character (or raw) device entries. Entries are in the form of decimal numbers and are assigned through lofiadm(1M). When created, these device entries are owned by root, in group sys and have permissions of 0600. Ownership, group, and permission settings can be altered, however there may be ramifications. See lofiadm(1M) for more information.
lofi devices can be compressed. See lofiadm(1M) for more information.
Files exported through lofi can also be encrypted. See lofiadm(1M) for details on how to specify encryption keys.
Master control device
Block device for file n
Character device for file n
32-bit driver
64-bit driver (SPARC)
64-bit driver (x86)
Driver configuration file. (Do not alter).
See attributes(5) for a description of the following attributes:
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| Architecture SPARC, x86 |
| Interface Stability Committed |
fstyp(1M), fsck(1M), mount(1M), lofiadm(1M), newfs(1M), attributes(5), lofs(7FS)
Just as you would not directly access a disk device that has mounted file systems, you should not access a file associated with a block device except through the lofi file driver.
For compatibility purposes, a raw device is also exported with the block device. (For example, newfs(1M)).
The lofi driver isn't available in a zone and will not work inside a zone.