From owner-freebsd-doc@FreeBSD.ORG Sat Dec 20 17:50:03 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9852D1065678 for ; Sat, 20 Dec 2008 17:50:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 749F28FC1E for ; Sat, 20 Dec 2008 17:50:03 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id mBKHo3w9013149 for ; Sat, 20 Dec 2008 17:50:03 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id mBKHo3uN013148; Sat, 20 Dec 2008 17:50:03 GMT (envelope-from gnats) Resent-Date: Sat, 20 Dec 2008 17:50:03 GMT Resent-Message-Id: <200812201750.mBKHo3uN013148@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chris Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BE037106564A for ; Sat, 20 Dec 2008 17:45:54 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id AC56A8FC16 for ; Sat, 20 Dec 2008 17:45:54 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id mBKHjsi5028289 for ; Sat, 20 Dec 2008 17:45:54 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id mBKHjsr9028288; Sat, 20 Dec 2008 17:45:54 GMT (envelope-from nobody) Message-Id: <200812201745.mBKHjsr9028288@www.freebsd.org> Date: Sat, 20 Dec 2008 17:45:54 GMT From: Chris To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/129792: mount_msdosfs(8) man page is missing the -o large option X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 20 Dec 2008 17:50:03 -0000 >Number: 129792 >Category: docs >Synopsis: mount_msdosfs(8) man page is missing the -o large option >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Dec 20 17:50:03 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Chris >Release: 7.1-PRERELEASE >Organization: >Environment: FreeBSD eco 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #1: Tue Dec 16 18:28:48 GMT 2008 root@eco:/usr/obj/usr/src/sys/GENERIC i386 >Description: /usr/src/sys/fs/msdosfs/msdosfs_vfsops.c lists 'large' as an option to mount_msdosfs but it is not described in the mount_msdosfs(8) man page. >How-To-Repeat: man 8 mount_msdosfs >Fix: Suggested change: --- mount_msdosfs.8.orig 2005-09-14 17:36:19.000000000 +0100 +++ mount_msdosfs.8 2008-12-20 17:40:11.000000000 +0000 @@ -79,6 +79,8 @@ Force only the old MS-DOS 8.3 style filenames to be visible. .It Cm nowin95 Completely ignore Windows 95 extended file information. +.It Cm large +Mount a file system larger than 128 GB. See CAVEATS section. .El .It Fl u Ar uid Set the owner of the files in the file system to @@ -208,6 +210,18 @@ Cluster sizes larger than 16K are unavoidable for file system sizes larger than 1G, and also occur when file systems larger than 1G are shrunk to smaller than 1G using FIPS. +.Pp +The +.Nm large +option uses at least 32 bytes of kernel memory (which is not +reclaimed until the FS is unmounted) for each file on disk to map +between the 32-bit inode numbers used by VFS and the 64-bit +pseudo-inode numbers used internally by msdosfs. This is only +safe to use in certain controlled situations (e.g. read-only FS +with less than 1 million files). +Since the mappings do not persist across unmounts (or reboots), these +filesystems are not suitable for exporting through NFS, or any other +application that requires fixed inode numbers. .Sh HISTORY The .Nm >Release-Note: >Audit-Trail: >Unformatted: