Install subscribers without the execute bit.
[openresolv] / resolvconf.8.in
index c60aa28eaf63badf3a5781dadbebba34ce2b1f5a..4e6f59a0449e08a21a307116508d7f65f91f3ec8 100644 (file)
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd November 22, 2009
+.Dd December 3, 2009
 .Dt RESOLVCONF 8 SMM
 .Os
 .Sh NAME
@@ -170,6 +170,21 @@ the operating systems lexical order.
 See
 .Xr resolvconf.conf 5
 for details on these lists.
+.Sh IMPLEMENTATION NOTES
+If a subscriber has the executable bit then it is executed otherwise it is
+assumed to be a shell script and sourced into the current environment in a
+subshell.
+This is done so that subscribers can remain fast, but are also not limited
+to the shell language.
+.Pp
+Portable subscribers should not use anything outside of
+.Pa /bin
+and
+.Pa /sbin
+because
+.Pa /usr
+and others may not be available when booting.
+Also, it would be unwise to assume any shell specific features.
 .Sh ENVIRONMENT
 .Bl -ohang
 .It Va IF_METRIC
@@ -215,8 +230,6 @@ You should consult
 .Xr resolvconf.conf 5
 for instructions on how to configure your resolver.
 .Sh SEE ALSO
-.Xr dnsmasq 8 ,
-.Xr named 8 ,
 .Xr resolv.conf 5 ,
 .Xr resolvconf.conf 5 ,
 .Xr resolver 3 ,