2011-08-13 20:20:01 +00:00
|
|
|
|
.TH SHR 3
|
|
|
|
|
|
.SH NAME
|
|
|
|
|
|
shr \- global mountpoints
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
|
.nf
|
|
|
|
|
|
.B bind -a '#σ/share' /dev
|
|
|
|
|
|
|
|
|
|
|
|
.BI #σ/ share1
|
|
|
|
|
|
.BI #σc/ share1/service1
|
|
|
|
|
|
.BI #σc/ share1/service2
|
|
|
|
|
|
...
|
|
|
|
|
|
.fi
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
The
|
|
|
|
|
|
.I shr
|
|
|
|
|
|
device provides global mountpoints in the form of share directories
|
2011-08-15 16:27:30 +00:00
|
|
|
|
where
|
|
|
|
|
|
.IR 9P
|
|
|
|
|
|
services can be mounted on.
|
2011-08-13 20:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
Effectively, it is a global mountpoint registry that is separate from
|
|
|
|
|
|
private namespaces.
|
|
|
|
|
|
.PP
|
|
|
|
|
|
The
|
|
|
|
|
|
.I shr
|
|
|
|
|
|
device exports a mount tree and a control tree. The directories
|
|
|
|
|
|
in the mount tree
|
|
|
|
|
|
.BI #σ
|
|
|
|
|
|
are the share mountpoints themselve and in the control tree
|
|
|
|
|
|
.BI #σc
|
2011-08-15 16:27:30 +00:00
|
|
|
|
share directories list the service files of the share.
|
2011-08-13 20:20:01 +00:00
|
|
|
|
.PP
|
|
|
|
|
|
To create a new share, create the directory
|
|
|
|
|
|
.B #σc/myshare
|
|
|
|
|
|
|
|
|
|
|
|
To mount a service in that share, create the file
|
|
|
|
|
|
.B #σc/myshare/myserv
|
|
|
|
|
|
and then write a text string (suitable for
|
|
|
|
|
|
.IR strtoul ;
|
|
|
|
|
|
see
|
|
|
|
|
|
.IR atof (2))
|
2011-08-15 16:27:30 +00:00
|
|
|
|
giving the file descriptor number of an open
|
|
|
|
|
|
.I 9P
|
|
|
|
|
|
service. Any process
|
2011-08-13 20:20:01 +00:00
|
|
|
|
with the proper permission may then access
|
|
|
|
|
|
.B #σ/myshare
|
2011-08-15 16:27:30 +00:00
|
|
|
|
on the mount tree.
|
2011-08-13 20:20:01 +00:00
|
|
|
|
.PP
|
2011-08-15 16:27:30 +00:00
|
|
|
|
The service file can be reopened and passed to
|
|
|
|
|
|
.IR mount
|
|
|
|
|
|
(see
|
|
|
|
|
|
.IR bind(2))
|
|
|
|
|
|
or added to another share.
|
|
|
|
|
|
.PP
|
|
|
|
|
|
Multiple services can be mounted under a share forming a union
|
|
|
|
|
|
directory. New services get mounted before old ones.
|
|
|
|
|
|
Removing the service file unmounts the service from the share.
|
|
|
|
|
|
.PP
|
|
|
|
|
|
Creating shares and mounts requires read-write access in the share
|
|
|
|
|
|
directory. The special user
|
|
|
|
|
|
.B none
|
|
|
|
|
|
is prohibited from these operations.
|
2011-08-13 20:20:01 +00:00
|
|
|
|
.SH SOURCE
|
|
|
|
|
|
.B /sys/src/9/port/devshr.c
|
