1*bbf21555SRichard Lowe.\" 2*bbf21555SRichard Lowe.\" Copyright (c) 1999 Sun Microsystems, Inc. 3*bbf21555SRichard Lowe.\" All Rights Reserved. 4*bbf21555SRichard Lowe.\" Copyright 2021 Oxide Computer Company 5*bbf21555SRichard Lowe.\" 6*bbf21555SRichard Lowe.\" The contents of this file are subject to the terms of the 7*bbf21555SRichard Lowe.\" Common Development and Distribution License (the "License"). 8*bbf21555SRichard Lowe.\" You may not use this file except in compliance with the License. 9*bbf21555SRichard Lowe.\" 10*bbf21555SRichard Lowe.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 11*bbf21555SRichard Lowe.\" or http://www.opensolaris.org/os/licensing. 12*bbf21555SRichard Lowe.\" See the License for the specific language governing permissions 13*bbf21555SRichard Lowe.\" and limitations under the License. 14*bbf21555SRichard Lowe.\" 15*bbf21555SRichard Lowe.\" When distributing Covered Code, include this CDDL HEADER in each 16*bbf21555SRichard Lowe.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE. 17*bbf21555SRichard Lowe.\" If applicable, add the following below this CDDL HEADER, with the 18*bbf21555SRichard Lowe.\" fields enclosed by brackets "[]" replaced with your own identifying 19*bbf21555SRichard Lowe.\" information: Portions Copyright [yyyy] [name of copyright owner] 20*bbf21555SRichard Lowe.\" 21*bbf21555SRichard Lowe.Dd June 20, 2021 22*bbf21555SRichard Lowe.Dt UDFS 4FS 23*bbf21555SRichard Lowe.Os 24*bbf21555SRichard Lowe.Sh NAME 25*bbf21555SRichard Lowe.Nm udfs 26*bbf21555SRichard Lowe.Nd universal disk format file system 27*bbf21555SRichard Lowe.Sh DESCRIPTION 28*bbf21555SRichard LoweThe 29*bbf21555SRichard Lowe.Nm 30*bbf21555SRichard Lowefile system is a file system type that allows user access to files on Universal 31*bbf21555SRichard LoweDisk Format (UDF) disks from within illumos. 32*bbf21555SRichard LoweOnce mounted, a 33*bbf21555SRichard Lowe.Nm 34*bbf21555SRichard Lowefile system provides standard file system operations and semantics. 35*bbf21555SRichard LoweThat is, users can read files, write files, and list files in a directory on a 36*bbf21555SRichard LoweUDF device and applications can use standard UNIX system calls on these files 37*bbf21555SRichard Loweand directories. 38*bbf21555SRichard Lowe.Pp 39*bbf21555SRichard LoweBecause 40*bbf21555SRichard Lowe.Nm 41*bbf21555SRichard Loweis a platform-independent file system, the same media can be written to and read 42*bbf21555SRichard Lowefrom by any operating system or vendor. 43*bbf21555SRichard Lowe.Ss "Mounting File Systems" 44*bbf21555SRichard Lowe.Nm 45*bbf21555SRichard Lowefile systems are mounted using: 46*bbf21555SRichard Lowe.Bd -literal -offset indent 47*bbf21555SRichard Lowemount -F udfs -o rw/ro device-special 48*bbf21555SRichard Lowe.Ed 49*bbf21555SRichard Lowe.Pp 50*bbf21555SRichard LoweUse: 51*bbf21555SRichard Lowe.Bd -literal -offset indent 52*bbf21555SRichard Lowemount /udfs 53*bbf21555SRichard Lowe.Ed 54*bbf21555SRichard Loweif the 55*bbf21555SRichard Lowe.Nm 56*bbf21555SRichard Loweand device special file 57*bbf21555SRichard Lowe.Pa /dev/dsk/c0t6d0s0 58*bbf21555SRichard Loweare valid and the following line 59*bbf21555SRichard Lowe.Pq or similar line 60*bbf21555SRichard Loweappears in your 61*bbf21555SRichard LowePa /etc/vfstab 62*bbf21555SRichard Lowefile: 63*bbf21555SRichard Lowe.Bd -literal -offset indent 64*bbf21555SRichard Lowe/dev/dsk/c0t6d0s0 - /udfs udfs - no ro 65*bbf21555SRichard Lowe.Ed 66*bbf21555SRichard Lowe.Pp 67*bbf21555SRichard LoweThe 68*bbf21555SRichard Lowe.Nm 69*bbf21555SRichard Lowefile system provides read-only support for ROM, RAM, and sequentially-recordable 70*bbf21555SRichard Lowemedia and read-write support on RAM media. 71*bbf21555SRichard Lowe.Pp 72*bbf21555SRichard LoweThe 73*bbf21555SRichard Lowe.Nm 74*bbf21555SRichard Lowefile system also supports regular files, directories, and symbolic links, as 75*bbf21555SRichard Lowewell as device nodes such as block, character, FIFO, and Socket. 76*bbf21555SRichard Lowe.Sh SEE ALSO 77*bbf21555SRichard Lowe.Xr vfstab 5 , 78*bbf21555SRichard Lowe.Xr mount 8 , 79*bbf21555SRichard Lowe.Xr mount_udfs 8 80*bbf21555SRichard Lowe.Sh NOTES 81*bbf21555SRichard LoweInvalid characters such as 82*bbf21555SRichard Lowe.Dq \e0 83*bbf21555SRichard Loweand 84*bbf21555SRichard Lowe.Dq / 85*bbf21555SRichard Loweand invalid file names 86*bbf21555SRichard Lowesuch as 87*bbf21555SRichard Lowe.Dq \ . 88*bbf21555SRichard Lowe.Dq \&. 89*bbf21555SRichard Loweand 90*bbf21555SRichard Lowe.Dq \&.\&. 91*bbf21555SRichard Lowewill be translated according to the following rule: 92*bbf21555SRichard Lowe.Pp 93*bbf21555SRichard LoweReplace the invalid character with an 94*bbf21555SRichard Lowe.Dq _ , 95*bbf21555SRichard Lowethen append the file name with 96*bbf21555SRichard Lowe.Dq # 97*bbf21555SRichard Lowefollowed by a 4 digit hex representation of the 16-bit CRC of the original 98*bbf21555SRichard Lowe.Sy FileIdentifier . 99*bbf21555SRichard LoweFor example, the file name 100*bbf21555SRichard Lowe.Dq \&.\&. 101*bbf21555SRichard Lowewill become 102*bbf21555SRichard Lowe.Dq __#4C05 . 103