From nobody@FreeBSD.org  Sat Dec 20 17:45:54 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id BE037106564A
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <cwhiteh@onetel.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: mount_msdosfs(8) man page is missing the -o large option
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         129792
>Category:       docs
>Synopsis:       [patch] mount_msdosfs(8) man page is missing the -o large option
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Dec 20 17:50:03 UTC 2008
>Closed-Date:    Wed Apr 01 06:20:16 UTC 2009
>Last-Modified:  Wed Apr 01 06:20:16 UTC 2009
>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:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Tue Dec 23 13:35:45 UTC 2008 
State-Changed-Why:  
Different patch applied to CURRENT, I will MFC later. 
Thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Dec 23 13:35:45 UTC 2008 
Responsible-Changed-Why:  
Over to me, MFC reminder. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=129792 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/129792: commit references a PR
Date: Wed,  1 Apr 2009 06:03:37 +0000 (UTC)

 Author: trhodes
 Date: Wed Apr  1 06:03:23 2009
 New Revision: 190606
 URL: http://svn.freebsd.org/changeset/base/190606
 
 Log:
   MFC r186429:
   Document the "-o large" option.
   
   PR:		129792
   
   And r186768:
   Add missing qualifier which was missed in the previous commit.
   
   Noticed by:	brooks
   
   Approved by:	re (kib)
 
 Modified:
   stable/7/sbin/mount_msdosfs/   (props changed)
   stable/7/sbin/mount_msdosfs/mount_msdosfs.8
 
 Modified: stable/7/sbin/mount_msdosfs/mount_msdosfs.8
 ==============================================================================
 --- stable/7/sbin/mount_msdosfs/mount_msdosfs.8	Wed Apr  1 06:01:40 2009	(r190605)
 +++ stable/7/sbin/mount_msdosfs/mount_msdosfs.8	Wed Apr  1 06:03:23 2009	(r190606)
 @@ -30,7 +30,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd April 7, 1994
 +.Dd December 23, 2008
  .Dt MOUNT_MSDOSFS 8
  .Os
  .Sh NAME
 @@ -73,6 +73,11 @@ as described in
  .Xr mount 8 .
  The following MSDOS file system-specific options are available:
  .Bl -tag -width indent
 +.It Cm large
 +Support file systems larger than 128 gigabytes at the expense
 +of 32 bytes of kernel memory for each file on disk.
 +This memory will not be reclaimed until the file system has
 +been unmounted.
  .It Cm longnames
  Force Windows 95 long filenames to be visible.
  .It Cm shortnames
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Apr 1 06:19:58 UTC 2009 
State-Changed-Why:  
MFC to 7 complete, thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=129792 
>Unformatted:
