.TH SHARESERVICE 1
.SH NAME
shareservice - start a listener to share 9p services
.SH SYNOPSIS
g/sharefiles servicename description port srvname
.SH DESCRIPTION
sharefiles creates a service sharing the service at /srv/SRVNAME using a listener on PORT. It creates an entry for this in /tmp/grid/svcout. The SERVICENAME and DESCRIPTION can be 'freely chosen' but it is a good idea to adhere to the semantic conventions of your grid. These text strings are given to the registry when an announcement is made, and other grid clients use these to find and attach your service. If you are using plan9 and have a correctly set node address using DESCRIPTION to store your public IP address is a bit unnecessary and you can provide other information in this slot. shareservice DOES NOT make any announcements on its own, you must notify the grid with g/tellreg. Also note that this is serving a world-writable and non-authenticated copy of the service. Use at your own risk!
.SH SOURCE
/bin/g
.SH BUGS
Currently shareservice assumes you wish to do public, non-authenticated filesharing to all grid clients. Support for choice of auth and encryption should be added.
