1.\" Copyright (c) 1989, 1991 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)exports.5 5.2 (Berkeley) 05/10/91 7.\" 8.Dd 9.Dt EXPORTS 5 10.Os 11.Sh NAME 12.Nm exports 13.Nd define remote mount points for 14.Tn NFS 15mount requests 16.Sh SYNOPSIS 17.Nm exports 18.Sh DESCRIPTION 19The 20.Nm exports 21file 22specifies remote mount points for the 23.Tn NFS 24mount protocol per the 25.Tn NFS 26server specification; see 27.%T "Network File System Protocol Specification \\*(tNRFC\\*(sP 1094" . 28.Pp 29Each line in the file specifies one remote mount point. 30The first field is the mount point directory path followed 31optionally by export options and specific hosts separated by white space. 32Only the first entry for a given local file system may specify the export 33options, since these are handled on a 34.Em per local file system 35basis. 36If no specific hosts are specified, 37the mount point is exported to all hosts. 38.Pp 39The export options are as follows: 40.Sm off 41.Fl root No = Aq Sy uid 42.Sm on 43specifies how to map root's uid (default -2). 44The option 45.Fl r 46is synonyms for 47.Fl root 48in an effort to be backward compatible with older export file formats. 49.Pp 50.Fl ro 51specifies that the file system should be exported Read-only 52(default Read/Write). 53The option 54.Fl o 55is synonyms for 56.Fl ro 57in an effort to be backward compatible with older export file formats. 58.Pp 59For example: 60.Bd -literal -offset indent 61/usr -root=0 rickers snowhite.cis.uoguelph.ca 62/usr/local 131.104.48.16 63/u -root=5 64/u2 -ro 65.Ed 66.Pp 67Given that 68.Sy /usr , 69.Sy /u 70and 71.Sy /u2 72are 73local file system mount points, the above example specifies the following: 74.Bd -filled -offset indent 75.Sy /usr 76is exported to hosts 77.Em rickers 78and 79.Em snowhite.cis.uoguelph.ca 80with 81root mapped to root. 82.Pp 83.Sy /usr/local 84is exported to host 85.Em 131.104.48.16 86with root mapped to root. 87.Pp 88.Sy /u 89is exported to all hosts with root mapped to uid 5. 90.Pp 91.Sy /u2 92is exported to all hosts Read-only with root mapped to -2. 93.Ed 94.Pp 95Note that 96.Dq Li "/usr/local -root=5" 97would have been incorrect, 98since 99.Sy /usr 100and 101.Sy /usr/local 102reside in the same local file system. 103.Sh FILES 104.Bl -tag -width /etc/exports -compact 105.It Pa /etc/exports 106The remote mount point file 107.Nm exports 108resides in 109.Pa /etc . 110.El 111.Sh SEE ALSO 112.Xr mountd 8 , 113.Xr nfsd 8 , 114.Xr showmount 8 115.Sh BUGS 116It would be nice if the export options were not tied to local mount points. 117.Sh HISTORY 118The 119.Nm 120file format is 121.Ud . 122