Differential D1210 Diff 2578 usr.sbin/autofs/auto_master.5

Changeset View

Standalone View

usr.sbin/autofs/auto_master.5

	Show All 21 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd November 21, 2014			.Dd November 22, 2014
	.Dt AUTO_MASTER 5			.Dt AUTO_MASTER 5
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm auto_master			.Nm auto_master
	.Nd auto_master and map file format			.Nd auto_master and map file format
	.Sh DESCRIPTION			.Sh DESCRIPTION
	The automounter configuration consists of the			The automounter configuration consists of the
	.Nm			.Nm
	▲ Show 20 Lines • Show All 168 Lines • ▼ Show 20 Lines
	.Li cd -fstype=cd9660 :/dev/cd0			.Li cd -fstype=cd9660 :/dev/cd0
	.Ed			.Ed
	.Sh SPECIAL MAPS			.Sh SPECIAL MAPS
	Special maps have names beginning with			Special maps have names beginning with
	.Li - .			.Li - .
	Supported special maps are:			Supported special maps are:
	.Pp			.Pp
	.Bl -tag -width "-hosts" -compact			.Bl -tag -width "-hosts" -compact
	.It Li -hosts			.It Li -hosts
	This map queries the remote NFS server and maps exported volumes.			Query the remote NFS server and map exported shares.
				wblockUnsubmitted Not Done Inline Actions This and the next two notes reword the entries in this list to avoid the passive and repeated "This map" and nonspecific "It". Query the remote NFS server and map exported volumes, which are traditionally mounted on .Pa /net . Files on a remote NFS server are typically accessed through the .Pa /net/nfs-server-ip/share-name/ directory without needing any additional configuration. wblock: This and the next two notes reword the entries in this list to avoid the passive and repeated…
				traszAuthorUnsubmitted Not Done Inline Actions Hm, but it's not the volumes that are mounted on /net, it's the map - volumes are somewhere underneath it. What do you think about the updated patch? trasz: Hm, but it's not the volumes that are mounted on /net, it's the map - volumes are somewhere…
	It is traditionally mounted on			This map is traditionally mounted on
				wblockUnsubmitted Not Done Inline Actions Phabricator might not be showing the actual diff, so bear with me. I see This map is traditionally mounted on .Pa /net , Does "traditionally" mean "by default", or "what most people do"? I suspect it is the first, so this can be split out of the too-long following sentence: By default, this map is mounted on .Pa /net . Access to files on a remote NFS server is provided through the .Pa /net/nfs-server-ip/share-name/ directory without any additional configuration. nfs-server-ip and share-name need markup to show they are not literal, although I have not yet found out what to use. wblock: Phabricator might not be showing the actual diff, so bear with me. I see This map is…
				traszAuthorUnsubmitted Not Done Inline Actions "Traditionally" here means "what our ancestors used to do". It's not mounted anywhere by default - it's commented out - but by removing a single "#" you can mount it where it used to be on Solaris and most other UNIX systems. And OS X. trasz: "Traditionally" here means "what our ancestors used to do". It's not mounted anywhere by…
	.Pa /net .			.Pa /net ,
	It enables access to files on a remote NFS server by accessing			and enables access to files on a remote NFS server through
	.Pa /net/nfs-server-ip/share-name/			.Pa /net/nfs-server-ip/share-name/
				wblockUnsubmitted Not Done Inline Actions Courtesy of Ingo Schwarze: .Pf /net/ Ar nfs-server-ip Ns / Ns Ar share-name Ns / That shows the full path, but makes it more obvious that nfs-server-ip and share-name are not literal values. wblock: Courtesy of Ingo Schwarze: .Pf /net/ Ar nfs-server-ip Ns / Ns Ar share-name Ns / That shows…
	directory, without the need for any further configuration.			directory, without the need for any further configuration.
				.It Li -media
				Query devices that are not yet mounted, but contain valid filesystems.
				Generally used to access files on removable media.
	.It Li -null			.It Li -null
				wblockUnsubmitted Not Done Inline Actions .It Li -media Query devices that are not yet mounted, but contain valid filesystems. Generally used for access to files on removable media. wblock: .It Li -media Query devices that are not yet mounted, but contain valid filesystems. Generally…
	This map prevents the			Prevent
				wblockUnsubmitted Not Done Inline Actions Prevent .Xr automountd 8 from mounting anything on the mountpoint. wblock: Prevent .Xr automountd 8 from mounting anything on the mountpoint.
	.Xr automountd 8			.Xr automountd 8
	from mounting anything on the mountpoint.			from mounting anything on the mountpoint.
	.El			.El
	.Sh EXECUTABLE MAPS			.Sh EXECUTABLE MAPS
	If the map file specified in			If the map file specified in
	.Nm			.Nm
	has execute bit set, the			has execute bit set, the
	.Xr automountd 8			.Xr automountd 8
	▲ Show 20 Lines • Show All 80 Lines • Show Last 20 Lines