am-utils.texi (51591) | am-utils.texi (52894) |
---|---|
1\input texinfo @c -*-texinfo-*- 2@c 3@c Copyright (c) 1997-1999 Erez Zadok 4@c Copyright (c) 1989 Jan-Simon Pendry 5@c Copyright (c) 1989 Imperial College of Science, Technology & Medicine 6@c Copyright (c) 1989 The Regents of the University of California. 7@c All rights reserved. 8@c --- 24 unchanged lines hidden (view full) --- 33@c DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 34@c OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 35@c HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 36@c LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 37@c OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 38@c 39@c %W% (Berkeley) %G% 40@c | 1\input texinfo @c -*-texinfo-*- 2@c 3@c Copyright (c) 1997-1999 Erez Zadok 4@c Copyright (c) 1989 Jan-Simon Pendry 5@c Copyright (c) 1989 Imperial College of Science, Technology & Medicine 6@c Copyright (c) 1989 The Regents of the University of California. 7@c All rights reserved. 8@c --- 24 unchanged lines hidden (view full) --- 33@c DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 34@c OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 35@c HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 36@c LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 37@c OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 38@c 39@c %W% (Berkeley) %G% 40@c |
41@c $Id: am-utils.texi,v 1.10 1999/09/08 23:36:49 ezk Exp $ | 41@c $Id: am-utils.texi,v 1.12 1999/09/30 21:01:39 ezk Exp $ |
42@c 43@setfilename am-utils.info 44 45@include version.texi 46 47@c info directory entry 48@direntry 49* Am-utils: (am-utils). The Amd automounter suite of utilities --- 834 unchanged lines hidden (view full) --- 884@item @b{i586-pc-linux-gnu-rh5.2} 885@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 886@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 887 888@item @b{i586-pc-linux-gnu-rh6.0} 889@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 890@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 891 | 42@c 43@setfilename am-utils.info 44 45@include version.texi 46 47@c info directory entry 48@direntry 49* Am-utils: (am-utils). The Amd automounter suite of utilities --- 834 unchanged lines hidden (view full) --- 884@item @b{i586-pc-linux-gnu-rh5.2} 885@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 886@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 887 888@item @b{i586-pc-linux-gnu-rh6.0} 889@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 890@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 891 |
892@item @b{i586-pc-linux-gnu-rh6.1} 893@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 894@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 895 |
|
892@item @b{i586-pc-linux-gnulibc1} 893@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 894@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 895 896@item @b{i586-pc-linux-gnulibc1-rh4.2} 897@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 898@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 899 --- 733 unchanged lines hidden (view full) --- 1633* byte Selector Variable:: 1634* cluster Selector Variable:: 1635* domain Selector Variable:: 1636* host Selector Variable:: 1637* hostd Selector Variable:: 1638* karch Selector Variable:: 1639* os Selector Variable:: 1640* osver Selector Variable:: | 896@item @b{i586-pc-linux-gnulibc1} 897@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 898@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 899 900@item @b{i586-pc-linux-gnulibc1-rh4.2} 901@c {Config} {Compile} {Amd} {NFS V.3} {Shlib} {Hlfsd} 902@tab yes @tab yes @tab yes @tab n/a @tab yes @tab ? 903 --- 733 unchanged lines hidden (view full) --- 1637* byte Selector Variable:: 1638* cluster Selector Variable:: 1639* domain Selector Variable:: 1640* host Selector Variable:: 1641* hostd Selector Variable:: 1642* karch Selector Variable:: 1643* os Selector Variable:: 1644* osver Selector Variable:: |
1645* full_os Selector Variable:: 1646* vendor Selector Variable:: |
|
1641 1642* key Selector Variable:: 1643* map Selector Variable:: 1644* netnumber Selector Variable:: 1645* network Selector Variable:: 1646* path Selector Variable:: 1647* wire Selector Variable:: 1648 --- 131 unchanged lines hidden (view full) --- 1780@cindex Selector; os 1781 1782The operating system. Like the machine architecture, this is 1783automatically determined at compile time. The operating system name can 1784be displayed by running the command @samp{amd -v}. @xref{Supported 1785Platforms}.@refill 1786 1787@c ---------------------------------------------------------------- | 1647 1648* key Selector Variable:: 1649* map Selector Variable:: 1650* netnumber Selector Variable:: 1651* network Selector Variable:: 1652* path Selector Variable:: 1653* wire Selector Variable:: 1654 --- 131 unchanged lines hidden (view full) --- 1786@cindex Selector; os 1787 1788The operating system. Like the machine architecture, this is 1789automatically determined at compile time. The operating system name can 1790be displayed by running the command @samp{amd -v}. @xref{Supported 1791Platforms}.@refill 1792 1793@c ---------------------------------------------------------------- |
1788@node osver Selector Variable, key Selector Variable, os Selector Variable, Selectors | 1794@node osver Selector Variable, full_os Selector Variable, os Selector Variable, Selectors |
1789@comment node-name, next, previous, up 1790@subsubsection osver Selector Variable 1791@cindex osver Selector Variable 1792@cindex osver, mount selector 1793@cindex Mount selector; osver 1794@cindex Selector; osver 1795 1796The operating system version. Like the machine architecture, this is 1797automatically determined at compile time. The operating system name can 1798be displayed by running the command @samp{amd -v}. @xref{Supported 1799Platforms}.@refill 1800 1801@c ---------------------------------------------------------------- | 1795@comment node-name, next, previous, up 1796@subsubsection osver Selector Variable 1797@cindex osver Selector Variable 1798@cindex osver, mount selector 1799@cindex Mount selector; osver 1800@cindex Selector; osver 1801 1802The operating system version. Like the machine architecture, this is 1803automatically determined at compile time. The operating system name can 1804be displayed by running the command @samp{amd -v}. @xref{Supported 1805Platforms}.@refill 1806 1807@c ---------------------------------------------------------------- |
1808@node full_os Selector Variable, vendor Selector Variable, osver Selector Variable, Selectors 1809@comment node-name, next, previous, up 1810@subsubsection full_os Selector Variable 1811@cindex full_os Selector Variable 1812@cindex full_os, mount selector 1813@cindex Mount selector; full_os 1814@cindex Selector; full_os 1815 1816The full name of the operating system, including its version. This 1817value is automatically determined at compile time. The full operating 1818system name and version can be displayed by running the command 1819@samp{amd -v}. @xref{Supported Platforms}.@refill 1820 1821@c ---------------------------------------------------------------- 1822@node vendor Selector Variable, key Selector Variable, full_os Selector Variable, Selectors 1823@comment node-name, next, previous, up 1824@subsubsection vendor Selector Variable 1825@cindex vendor Selector Variable 1826@cindex vendor, mount selector 1827@cindex Mount selector; vendor 1828@cindex Selector; vendor 1829 1830The name of the vendor of the operating system. This value is 1831automatically determined at compile time. The name of the vendor can be 1832displayed by running the command @samp{amd -v}. @xref{Supported 1833Platforms}.@refill 1834 1835@c ---------------------------------------------------------------- |
|
1802@ifhtml 1803<HR> 1804@end ifhtml 1805@sp 3 1806The following selectors are also provided. Unlike the other selectors, 1807they vary for each lookup. Note that when the name from the kernel is 1808expanded prior to a map lookup, these selectors are all defined as empty 1809strings. 1810 1811@c ---------------------------------------------------------------- | 1836@ifhtml 1837<HR> 1838@end ifhtml 1839@sp 3 1840The following selectors are also provided. Unlike the other selectors, 1841they vary for each lookup. Note that when the name from the kernel is 1842expanded prior to a map lookup, these selectors are all defined as empty 1843strings. 1844 1845@c ---------------------------------------------------------------- |
1812@node key Selector Variable, map Selector Variable, osver Selector Variable, Selectors | 1846@node key Selector Variable, map Selector Variable, vendor Selector Variable, Selectors |
1813@comment node-name, next, previous, up 1814@subsubsection key Selector Variable 1815@cindex key Selector Variable 1816@cindex key, mount selector 1817@cindex Mount selector; key 1818@cindex Selector; key 1819 1820The name being resolved. For example, if @file{/home} is an automount --- 122 unchanged lines hidden (view full) --- 1943 1944For example, suppose you have a netgroup @samp{ppp-hosts}, and for 1945reasons of performance, these have a local @file{/home} partition, while 1946all other clients on the faster network can access a shared home 1947directory. A common map to use for both might look like the following: 1948 1949@example 1950home/* netgrp(ppp-hosts);type:=link;fs:=/local/$@{key@} \ | 1847@comment node-name, next, previous, up 1848@subsubsection key Selector Variable 1849@cindex key Selector Variable 1850@cindex key, mount selector 1851@cindex Mount selector; key 1852@cindex Selector; key 1853 1854The name being resolved. For example, if @file{/home} is an automount --- 122 unchanged lines hidden (view full) --- 1977 1978For example, suppose you have a netgroup @samp{ppp-hosts}, and for 1979reasons of performance, these have a local @file{/home} partition, while 1980all other clients on the faster network can access a shared home 1981directory. A common map to use for both might look like the following: 1982 1983@example 1984home/* netgrp(ppp-hosts);type:=link;fs:=/local/$@{key@} \ |
1951 !netgrp(ppp-hosts);type:=nfs;rhost=serv1;rfs:=/remote/$@{key@} | 1985 !netgrp(ppp-hosts);type:=nfs;rhost:=serv1;rfs:=/remote/$@{key@} |
1952@end example 1953 1954@c ---------------------------------------------------------------- 1955@node netgrpd Selector Function, in_network Selector Function, netgrp Selector Function, Selectors 1956@comment node-name, next, previous, up 1957@subsubsection netgrpd Selector Function 1958@cindex netgrpd Selector Function 1959@cindex netgrpd, boolean mount selector --- 754 unchanged lines hidden (view full) --- 2714 2715@c ---------------------------------------------------------------- 2716@node -o Option, -p Option, -n Option, Amd Command Line Options 2717@comment node-name, next, previous, up 2718@section @code{-o} @var{op-sys-ver} 2719@cindex Operating System version 2720@cindex Setting the Operating System version 2721 | 1986@end example 1987 1988@c ---------------------------------------------------------------- 1989@node netgrpd Selector Function, in_network Selector Function, netgrp Selector Function, Selectors 1990@comment node-name, next, previous, up 1991@subsubsection netgrpd Selector Function 1992@cindex netgrpd Selector Function 1993@cindex netgrpd, boolean mount selector --- 754 unchanged lines hidden (view full) --- 2748 2749@c ---------------------------------------------------------------- 2750@node -o Option, -p Option, -n Option, Amd Command Line Options 2751@comment node-name, next, previous, up 2752@section @code{-o} @var{op-sys-ver} 2753@cindex Operating System version 2754@cindex Setting the Operating System version 2755 |
2722Override the compiled-in version number of the operating system, with | 2756Overrides the compiled-in version number of the operating system, with |
2723@var{op-sys-ver}. Useful when the built-in version is not desired for 2724backward compatibility reasons. For example, if the built-in version is 2725@samp{2.5.1}, you can override it to @samp{5.5.1}, and use older maps 2726that were written with the latter in mind. 2727 2728@c ---------------------------------------------------------------- 2729@node -p Option, -r Option, -o Option, Amd Command Line Options 2730@comment node-name, next, previous, up --- 26 unchanged lines hidden (view full) --- 2757@c @dfn{This option will be made the default in the next release.} 2758 2759@c ---------------------------------------------------------------- 2760@node -t Option, -v Option, -r Option, Amd Command Line Options 2761@comment node-name, next, previous, up 2762@section @code{-t} @var{timeout.retransmit} 2763@cindex Setting Amd's RPC parameters 2764 | 2757@var{op-sys-ver}. Useful when the built-in version is not desired for 2758backward compatibility reasons. For example, if the built-in version is 2759@samp{2.5.1}, you can override it to @samp{5.5.1}, and use older maps 2760that were written with the latter in mind. 2761 2762@c ---------------------------------------------------------------- 2763@node -p Option, -r Option, -o Option, Amd Command Line Options 2764@comment node-name, next, previous, up --- 26 unchanged lines hidden (view full) --- 2791@c @dfn{This option will be made the default in the next release.} 2792 2793@c ---------------------------------------------------------------- 2794@node -t Option, -v Option, -r Option, Amd Command Line Options 2795@comment node-name, next, previous, up 2796@section @code{-t} @var{timeout.retransmit} 2797@cindex Setting Amd's RPC parameters 2798 |
2765Specifies the RPC @dfn{timeout} and @dfn{retransmit} intervals used by 2766the kernel to communicate to @i{Amd}. These are used to set the 2767@samp{timeo} and @samp{retrans} mount options. | 2799Specifies the RPC @dfn{timeout} interval and the @dfn{retransmit} 2800counter used by the kernel to communicate to @i{Amd}. These are used to 2801set the @samp{timeo} and @samp{retrans} mount options, respectively. 2802The default timeout is 0.8 seconds, and the default number of 2803retransmissions is 11. |
2768 2769@i{Amd} relies on the kernel RPC retransmit mechanism to trigger mount | 2804 2805@i{Amd} relies on the kernel RPC retransmit mechanism to trigger mount |
2770retries. The value of this parameter changes the retry interval. Too 2771long an interval gives poor interactive response, too short an interval 2772causes excessive retries. | 2806retries. The values of these parameters change the overall retry 2807interval. Too long an interval gives poor interactive response; too 2808short an interval causes excessive retries. |
2773 2774@c ---------------------------------------------------------------- 2775@node -v Option, -w Option, -t Option, Amd Command Line Options 2776@comment node-name, next, previous, up 2777@section @code{-v} 2778@cindex Version information 2779@cindex Discovering version information 2780@cindex How to discover your version of Amd --- 18 unchanged lines hidden (view full) --- 2799Network 2: wire="14-net.cs.columbia.edu" (netnumber=128.59.14). 2800Network 3: wire="old-net.cs.columbia.edu" (netnumber=128.59.16). 2801@end example 2802 2803The information includes the version number, number of times @i{Amd} was 2804compiled on the local system, release date and name of the release. 2805Following come the cpu type, byte ordering, and the architecture and 2806kernel architecture as @code{$@{arch@}} and @code{$@{karch@}}, | 2809 2810@c ---------------------------------------------------------------- 2811@node -v Option, -w Option, -t Option, Amd Command Line Options 2812@comment node-name, next, previous, up 2813@section @code{-v} 2814@cindex Version information 2815@cindex Discovering version information 2816@cindex How to discover your version of Amd --- 18 unchanged lines hidden (view full) --- 2835Network 2: wire="14-net.cs.columbia.edu" (netnumber=128.59.14). 2836Network 3: wire="old-net.cs.columbia.edu" (netnumber=128.59.16). 2837@end example 2838 2839The information includes the version number, number of times @i{Amd} was 2840compiled on the local system, release date and name of the release. 2841Following come the cpu type, byte ordering, and the architecture and 2842kernel architecture as @code{$@{arch@}} and @code{$@{karch@}}, |
2807respectively. The next line lists the full name of the system, the 2808variables @code{$@{os@}} and @code{$@{osver@}}, and the vendor's 2809name. @xref{Supported Platforms}. | 2843respectively. The next line lists the operating system full name, short 2844name, version, and vendor. These four values correspond to the 2845variables @code{$@{full_os@}}, @code{$@{os@}}, @code{$@{osver@}}, and 2846@code{$@{vendor@}}, respectively. @xref{Supported Platforms}. |
2810 2811Then come a list of map types supported, filesystems internally 2812supported by @i{Amd} (AMFS), and generic filesystems available (FS). 2813Finally all known networks (if any) of this host are listed by name 2814and number. They are available via the variables 2815@code{$@{wire@}} or @code{$@{network@}}, and 2816@code{$@{netnumber@}} (@pxref{Selectors}) or the @samp{in_network} 2817selector function (@pxref{in_network Selector Function}). --- 159 unchanged lines hidden (view full) --- 2977trace memory allocations 2978@item mtab 2979use local @file{./mtab} file 2980@item str 2981debug string munging 2982@item test 2983full debug but no daemon 2984@item trace | 2847 2848Then come a list of map types supported, filesystems internally 2849supported by @i{Amd} (AMFS), and generic filesystems available (FS). 2850Finally all known networks (if any) of this host are listed by name 2851and number. They are available via the variables 2852@code{$@{wire@}} or @code{$@{network@}}, and 2853@code{$@{netnumber@}} (@pxref{Selectors}) or the @samp{in_network} 2854selector function (@pxref{in_network Selector Function}). --- 159 unchanged lines hidden (view full) --- 3014trace memory allocations 3015@item mtab 3016use local @file{./mtab} file 3017@item str 3018debug string munging 3019@item test 3020full debug but no daemon 3021@item trace |
2985protocol trace | 3022trace RPC protocol and NFS mount arguments |
2986@end table 2987 2988You may also refer to the program source for a more detailed explanation 2989of the available options. 2990 2991@c ---------------------------------------------------------------- 2992@node -F Option, -H Option, -D-Option, Amd Command Line Options 2993@comment node-name, next, previous, up --- 23 unchanged lines hidden (view full) --- 3017 3018@c ---------------------------------------------------------------- 3019@node -O-Option, -S Option, -H Option, Amd Command Line Options 3020@comment node-name, next, previous, up 3021@section @code{-O} @var{op-sys-name} 3022@cindex Operating System name 3023@cindex Setting the Operating System name 3024 | 3023@end table 3024 3025You may also refer to the program source for a more detailed explanation 3026of the available options. 3027 3028@c ---------------------------------------------------------------- 3029@node -F Option, -H Option, -D-Option, Amd Command Line Options 3030@comment node-name, next, previous, up --- 23 unchanged lines hidden (view full) --- 3054 3055@c ---------------------------------------------------------------- 3056@node -O-Option, -S Option, -H Option, Amd Command Line Options 3057@comment node-name, next, previous, up 3058@section @code{-O} @var{op-sys-name} 3059@cindex Operating System name 3060@cindex Setting the Operating System name 3061 |
3025Override the compiled-in name of the operating system, with | 3062Overrides the compiled-in name of the operating system, with |
3026@var{op-sys-name}. Useful when the built-in name is not desired for 3027backward compatibility reasons. For example, if the build in name is 3028@samp{sunos5}, you can override it to the old name @samp{sos5}, and use 3029older maps which were written with the latter in mind. 3030 3031@c ---------------------------------------------------------------- 3032@node -S Option, -T-Option, -O-Option, Amd Command Line Options 3033@comment node-name, next, previous, up --- 524 unchanged lines hidden (view full) --- 3558@node Program Filesystem, Symbolic Link Filesystem, User ID Mapping Filesystem, Filesystem Types 3559@comment node-name, next, previous, up 3560@section Program Filesystem (@samp{program}) 3561@cindex Program filesystem 3562@cindex Mount a filesystem under program control 3563@cindex program, filesystem type 3564@cindex Filesystem type; program 3565 | 3063@var{op-sys-name}. Useful when the built-in name is not desired for 3064backward compatibility reasons. For example, if the build in name is 3065@samp{sunos5}, you can override it to the old name @samp{sos5}, and use 3066older maps which were written with the latter in mind. 3067 3068@c ---------------------------------------------------------------- 3069@node -S Option, -T-Option, -O-Option, Amd Command Line Options 3070@comment node-name, next, previous, up --- 524 unchanged lines hidden (view full) --- 3595@node Program Filesystem, Symbolic Link Filesystem, User ID Mapping Filesystem, Filesystem Types 3596@comment node-name, next, previous, up 3597@section Program Filesystem (@samp{program}) 3598@cindex Program filesystem 3599@cindex Mount a filesystem under program control 3600@cindex program, filesystem type 3601@cindex Filesystem type; program 3602 |
3566The @dfn{program} (@samp{type:=program}) filesystem type allows a program to be run whenever a 3567mount or unmount is required. This allows easy addition of support for 3568other filesystem types, such as MIT's Remote Virtual Disk (RVD) 3569which has a programmatic interface via the commands 3570@samp{rvdmount} and @samp{rvdunmount}. | 3603The @dfn{program} (@samp{type:=program}) filesystem type allows a 3604program to be run whenever a mount or unmount is required. This allows 3605easy addition of support for other filesystem types, such as MIT's 3606Remote Virtual Disk (RVD) which has a programmatic interface via the 3607commands @samp{rvdmount} and @samp{rvdunmount}. |
3571 3572@noindent 3573The following options must be specified: 3574 3575@table @code 3576@cindex mount, mount option 3577@cindex Mount option; mount 3578@item mount --- 168 unchanged lines hidden (view full) --- 3747mount points. An automount mount point can also appear as a 3748sub-directory of an existing automount point. This allows some 3749additional structure to be added, for example to mimic the mount tree of 3750another machine. 3751 3752The following options may be specified: 3753 3754@table @code | 3608 3609@noindent 3610The following options must be specified: 3611 3612@table @code 3613@cindex mount, mount option 3614@cindex Mount option; mount 3615@item mount --- 168 unchanged lines hidden (view full) --- 3784mount points. An automount mount point can also appear as a 3785sub-directory of an existing automount point. This allows some 3786additional structure to be added, for example to mimic the mount tree of 3787another machine. 3788 3789The following options may be specified: 3790 3791@table @code |
3755@cindex cache, mount option 3756@cindex Mount option; cache | 3792@cindex cache, mount map option 3793@cindex Mount map option; cache |
3757@item cache 3758specifies whether the data in this mount-map should be 3759cached. The default value is @samp{none}, in which case 3760no caching is done in order to conserve memory. | 3794@item cache 3795specifies whether the data in this mount-map should be 3796cached. The default value is @samp{none}, in which case 3797no caching is done in order to conserve memory. |
3798 |
|
3761However, better performance and reliability can be obtained by caching 3762some or all of a mount-map. 3763 3764If the cache option specifies @samp{all}, 3765the entire map is enumerated when the mount point is created. 3766 3767If the cache option specifies @samp{inc}, caching is done incrementally 3768as and when data is required. --- 72 unchanged lines hidden (view full) --- 3841@node Direct Automount Filesystem, Union Filesystem, Automount Filesystem, Filesystem Types 3842@comment node-name, next, previous, up 3843@section Direct Automount Filesystem (@samp{direct}) 3844@cindex Direct automount filesystem 3845@cindex How to start a direct automount point 3846@cindex direct, filesystem type 3847@cindex Filesystem type; direct 3848 | 3799However, better performance and reliability can be obtained by caching 3800some or all of a mount-map. 3801 3802If the cache option specifies @samp{all}, 3803the entire map is enumerated when the mount point is created. 3804 3805If the cache option specifies @samp{inc}, caching is done incrementally 3806as and when data is required. --- 72 unchanged lines hidden (view full) --- 3879@node Direct Automount Filesystem, Union Filesystem, Automount Filesystem, Filesystem Types 3880@comment node-name, next, previous, up 3881@section Direct Automount Filesystem (@samp{direct}) 3882@cindex Direct automount filesystem 3883@cindex How to start a direct automount point 3884@cindex direct, filesystem type 3885@cindex Filesystem type; direct 3886 |
3849The @dfn{direct} (@samp{type:=direct}) filesystem is almost identical to the automount 3850filesystem. Instead of appearing to be a directory of mount points, it 3851appears as a symbolic link to a mounted filesystem. The mount is done 3852at the time the link is accessed. @xref{Automount Filesystem}, for a 3853list of required options. | 3887The @dfn{direct} (@samp{type:=direct}) filesystem is almost identical to 3888the automount filesystem. Instead of appearing to be a directory of 3889mount points, it appears as a symbolic link to a mounted filesystem. 3890The mount is done at the time the link is accessed. @xref{Automount 3891Filesystem}, for a list of required options. |
3854 3855Direct automount points are created by specifying the @samp{direct} 3856filesystem type on the command line: 3857 3858@example 3859amd ... /usr/man auto.direct -type:=direct 3860@end example 3861 --- 325 unchanged lines hidden (view full) --- 4187 4188@menu 4189* arch Parameter:: 4190* auto_dir Parameter:: 4191* cache_duration Parameter:: 4192* cluster Parameter:: 4193* debug_options Parameter:: 4194* dismount_interval Parameter:: | 3892 3893Direct automount points are created by specifying the @samp{direct} 3894filesystem type on the command line: 3895 3896@example 3897amd ... /usr/man auto.direct -type:=direct 3898@end example 3899 --- 325 unchanged lines hidden (view full) --- 4225 4226@menu 4227* arch Parameter:: 4228* auto_dir Parameter:: 4229* cache_duration Parameter:: 4230* cluster Parameter:: 4231* debug_options Parameter:: 4232* dismount_interval Parameter:: |
4233* full_os Parameter:: |
|
4195* fully_qualified_hosts Parameter:: 4196* hesiod_base Parameter:: 4197* karch Parameter:: 4198* ldap_base Parameter:: 4199* ldap_cache_maxmem Parameter:: 4200* ldap_cache_seconds Parameter:: 4201* ldap_hostports Parameter:: 4202* local_domain Parameter:: --- 9 unchanged lines hidden (view full) --- 4212* plock Parameter:: 4213* portmap_program Parameter:: 4214* print_pid Parameter:: 4215* print_version Parameter:: 4216* restart_mounts Parameter:: 4217* selectors_on_default Parameter:: 4218* show_statfs_entries Parameter:: 4219* unmount_on_exit Parameter:: | 4234* fully_qualified_hosts Parameter:: 4235* hesiod_base Parameter:: 4236* karch Parameter:: 4237* ldap_base Parameter:: 4238* ldap_cache_maxmem Parameter:: 4239* ldap_cache_seconds Parameter:: 4240* ldap_hostports Parameter:: 4241* local_domain Parameter:: --- 9 unchanged lines hidden (view full) --- 4251* plock Parameter:: 4252* portmap_program Parameter:: 4253* print_pid Parameter:: 4254* print_version Parameter:: 4255* restart_mounts Parameter:: 4256* selectors_on_default Parameter:: 4257* show_statfs_entries Parameter:: 4258* unmount_on_exit Parameter:: |
4259* vendor Parameter:: |
|
4220@end menu 4221 4222@c ---------------------------------------------------------------- 4223@node arch Parameter, auto_dir Parameter, Global Parameters, Global Parameters 4224@comment node-name, next, previous, up 4225@subsection @t{arch} Parameter 4226@cindex arch Parameter 4227 --- 30 unchanged lines hidden (view full) --- 4258@i{Amd}. Specifies the alternate HP-UX cluster to use. 4259 4260@c ---------------------------------------------------------------- 4261@node debug_options Parameter, dismount_interval Parameter, cluster Parameter, Global Parameters 4262@comment node-name, next, previous, up 4263@subsection @t{debug_options} Parameter 4264@cindex debug_options Parameter 4265 | 4260@end menu 4261 4262@c ---------------------------------------------------------------- 4263@node arch Parameter, auto_dir Parameter, Global Parameters, Global Parameters 4264@comment node-name, next, previous, up 4265@subsection @t{arch} Parameter 4266@cindex arch Parameter 4267 --- 30 unchanged lines hidden (view full) --- 4298@i{Amd}. Specifies the alternate HP-UX cluster to use. 4299 4300@c ---------------------------------------------------------------- 4301@node debug_options Parameter, dismount_interval Parameter, cluster Parameter, Global Parameters 4302@comment node-name, next, previous, up 4303@subsection @t{debug_options} Parameter 4304@cindex debug_options Parameter 4305 |
4266(type=string, default no debug options). Same as the @code{-D} 4267option to @i{Amd}. Specify any debugging options for @i{Amd}. Works 4268only if am-utils was configured for debugging using the 4269@code{--enable-debug} option. The @samp{mem} option alone can be turned 4270on via @code{--enable-debug=mem}. Otherwise debugging options are 4271ignored. Options are comma delimited, and can be preceded by the string 4272@samp{no} to negate their meaning. You can get the list of supported 4273debugging options by running @code{amd -v}. Possible values are: | 4306(type=string, default no debug options). Same as the @code{-D} option 4307to @i{Amd}. Specify any debugging options for @i{Amd}. Works only if 4308am-utils was configured for debugging using the @code{--enable-debug} 4309option. The @samp{mem} option, as well as all other options, can be 4310turned on via @code{--enable-debug=mem}. Otherwise debugging options 4311are ignored. Options are comma delimited, and can be preceded by the 4312string @samp{no} to negate their meaning. You can get the list of 4313supported debugging and logging options by running @code{amd -H}. 4314Possible values are: |
4274 4275@table @samp 4276@item all 4277all options 4278@item amq 4279register for amq 4280@item daemon 4281enter daemon mode --- 5 unchanged lines hidden (view full) --- 4287trace memory allocations 4288@item mtab 4289use local @file{./mtab} file 4290@item str 4291debug string munging 4292@item test 4293full debug but no daemon 4294@item trace | 4315 4316@table @samp 4317@item all 4318all options 4319@item amq 4320register for amq 4321@item daemon 4322enter daemon mode --- 5 unchanged lines hidden (view full) --- 4328trace memory allocations 4329@item mtab 4330use local @file{./mtab} file 4331@item str 4332debug string munging 4333@item test 4334full debug but no daemon 4335@item trace |
4295protocol trace | 4336trace RPC protocol and NFS mount arguments |
4296@end table 4297 4298@c ---------------------------------------------------------------- | 4337@end table 4338 4339@c ---------------------------------------------------------------- |
4299@node dismount_interval Parameter, fully_qualified_hosts Parameter, debug_options Parameter, Global Parameters | 4340@node dismount_interval Parameter, full_os Parameter, debug_options Parameter, Global Parameters |
4300@comment node-name, next, previous, up 4301@subsection @t{dismount_interval} Parameter 4302@cindex dismount_interval Parameter 4303 4304(type=numeric, default=120). Same as the @code{-w} option to 4305@i{Amd}. Specify in seconds, the time between attempts to dismount file 4306systems that have exceeded their cached times. 4307 4308@c ---------------------------------------------------------------- | 4341@comment node-name, next, previous, up 4342@subsection @t{dismount_interval} Parameter 4343@cindex dismount_interval Parameter 4344 4345(type=numeric, default=120). Same as the @code{-w} option to 4346@i{Amd}. Specify in seconds, the time between attempts to dismount file 4347systems that have exceeded their cached times. 4348 4349@c ---------------------------------------------------------------- |
4309@node fully_qualified_hosts Parameter, hesiod_base Parameter, dismount_interval Parameter, Global Parameters | 4350@node full_os Parameter, fully_qualified_hosts Parameter, dismount_interval Parameter, Global Parameters |
4310@comment node-name, next, previous, up | 4351@comment node-name, next, previous, up |
4352@subsection @t{full_os} Parameter 4353@cindex full_os Parameter 4354 4355(type=string, default to compiled in value). The full name of the 4356operating system, along with its version. Allows you to override the 4357compiled-in full name and version of the operating system. Useful when 4358the compiled-in name is not desired. For example, the full operating 4359system name on linux comes up as @samp{linux}, but you can override it 4360to @samp{linux-2.2.5}. 4361 4362@c ---------------------------------------------------------------- 4363@node fully_qualified_hosts Parameter, hesiod_base Parameter, full_os Parameter, Global Parameters 4364@comment node-name, next, previous, up |
|
4311@subsection @t{fully_qualified_hosts} Parameter 4312@cindex fully_qualified_hosts Parameter 4313 4314(type=string, default=@samp{no}). If @samp{yes}, @i{Amd} will perform RPC 4315authentication using fully-qualified host names. This is necessary for 4316some systems, and especially when performing cross-domain mounting. For 4317this function to work, the @i{Amd} variable @samp{$@{hostd@}} is used, 4318requiring that @samp{$@{domain@}} not be null. --- 98 unchanged lines hidden (view full) --- 4417@subsection @t{log_options} Parameter 4418@cindex log_options Parameter 4419 4420(type=string, default no logging options). Same as the @code{-x} 4421option to @i{Amd}. Specify any logging options for @i{Amd}. Options 4422are comma delimited, and can be preceded by the string @samp{no} to 4423negate their meaning. The @samp{debug} logging option is only available 4424if am-utils was configured with @code{--enable-debug}. You can get the | 4365@subsection @t{fully_qualified_hosts} Parameter 4366@cindex fully_qualified_hosts Parameter 4367 4368(type=string, default=@samp{no}). If @samp{yes}, @i{Amd} will perform RPC 4369authentication using fully-qualified host names. This is necessary for 4370some systems, and especially when performing cross-domain mounting. For 4371this function to work, the @i{Amd} variable @samp{$@{hostd@}} is used, 4372requiring that @samp{$@{domain@}} not be null. --- 98 unchanged lines hidden (view full) --- 4471@subsection @t{log_options} Parameter 4472@cindex log_options Parameter 4473 4474(type=string, default no logging options). Same as the @code{-x} 4475option to @i{Amd}. Specify any logging options for @i{Amd}. Options 4476are comma delimited, and can be preceded by the string @samp{no} to 4477negate their meaning. The @samp{debug} logging option is only available 4478if am-utils was configured with @code{--enable-debug}. You can get the |
4425list of supported debugging options by running @code{amd -v}. Possible | 4479list of supported debugging options by running @code{amd -H}. Possible |
4426values are: 4427 4428@table @samp 4429@item all 4430all messages 4431@item debug 4432debug messages 4433@item error --- 15 unchanged lines hidden (view full) --- 4449@end table 4450 4451@c ---------------------------------------------------------------- 4452@node nfs_retransmit_counter Parameter, nfs_retry_interval Parameter, log_options Parameter, Global Parameters 4453@comment node-name, next, previous, up 4454@subsection @t{nfs_retransmit_counter} Parameter 4455@cindex nfs_retransmit_counter Parameter 4456 | 4480values are: 4481 4482@table @samp 4483@item all 4484all messages 4485@item debug 4486debug messages 4487@item error --- 15 unchanged lines hidden (view full) --- 4503@end table 4504 4505@c ---------------------------------------------------------------- 4506@node nfs_retransmit_counter Parameter, nfs_retry_interval Parameter, log_options Parameter, Global Parameters 4507@comment node-name, next, previous, up 4508@subsection @t{nfs_retransmit_counter} Parameter 4509@cindex nfs_retransmit_counter Parameter 4510 |
4457(type=numeric, default=110). Same as the @i{counter} part of the 4458@code{-t} @i{interval.counter} option to @i{Amd}. Specifies the 4459retransmit counter's value in @emph{tenths} of seconds. | 4511(type=numeric, default=11). Same as the @i{retransmit} part of the 4512@code{-t} @i{timeout.retransmit} option to @i{Amd}. Specifies the 4513number of NFS retransmissions that the kernel will use to communicate 4514with @i{Amd}. @xref{-t Option}. |
4460 4461@c ---------------------------------------------------------------- 4462@node nfs_retry_interval Parameter, nis_domain Parameter, nfs_retransmit_counter Parameter, Global Parameters 4463@comment node-name, next, previous, up 4464@subsection @t{nfs_retry_interval} Parameter 4465@cindex nfs_retry_interval Parameter 4466 | 4515 4516@c ---------------------------------------------------------------- 4517@node nfs_retry_interval Parameter, nis_domain Parameter, nfs_retransmit_counter Parameter, Global Parameters 4518@comment node-name, next, previous, up 4519@subsection @t{nfs_retry_interval} Parameter 4520@cindex nfs_retry_interval Parameter 4521 |
4467(type=numeric, default=8). Same as the @i{interval} part of the 4468@code{-t} @i{interval.counter} option to @i{Amd}. Specifies the 4469interval in @emph{tenths} of seconds, between NFS/RPC/UDP retries. | 4522(type=numeric, default=8). Same as the @i{timeout} part of the 4523@code{-t} @i{timeout.retransmit} option to @i{Amd}. Specifies the NFS 4524timeout interval, in @emph{tenths} of seconds, between NFS/RPC retries 4525(for UDP only). This is the value that the kernel will use to 4526communicate with @i{Amd}. @xref{-t Option}. |
4470 | 4527 |
4528Amd relies on the kernel RPC retransmit mechanism to trigger mount 4529retries. The values of the @i{nfs_retransmit_counter} and the 4530@i{nfs_retry_interval} parameters change the overall retry interval. 4531Too long an interval gives poor interactive response; too short an 4532interval causes excessive retries. 4533 |
|
4471@c ---------------------------------------------------------------- 4472@node nis_domain Parameter, normalize_hostnames Parameter, nfs_retry_interval Parameter, Global Parameters 4473@comment node-name, next, previous, up 4474@subsection @t{nis_domain} Parameter 4475@cindex nis_domain Parameter 4476 4477(type=string, default to local NIS domain name). Same as the 4478@code{-y} option to @i{Amd}. Specify an alternative NIS domain from --- 19 unchanged lines hidden (view full) --- 4498 4499(type=string, default to compiled in value). Same as the @code{-O} 4500option to @i{Amd}. Allows you to override the compiled-in name of the 4501operating system. Useful when the built-in name is not desired for 4502backward compatibility reasons. For example, if the built-in name is 4503@samp{sunos5}, you can override it to @samp{sos5}, and use older maps 4504which were written with the latter in mind. 4505 | 4534@c ---------------------------------------------------------------- 4535@node nis_domain Parameter, normalize_hostnames Parameter, nfs_retry_interval Parameter, Global Parameters 4536@comment node-name, next, previous, up 4537@subsection @t{nis_domain} Parameter 4538@cindex nis_domain Parameter 4539 4540(type=string, default to local NIS domain name). Same as the 4541@code{-y} option to @i{Amd}. Specify an alternative NIS domain from --- 19 unchanged lines hidden (view full) --- 4561 4562(type=string, default to compiled in value). Same as the @code{-O} 4563option to @i{Amd}. Allows you to override the compiled-in name of the 4564operating system. Useful when the built-in name is not desired for 4565backward compatibility reasons. For example, if the built-in name is 4566@samp{sunos5}, you can override it to @samp{sos5}, and use older maps 4567which were written with the latter in mind. 4568 |
4569 |
|
4506@c ---------------------------------------------------------------- 4507@node osver Parameter, pid_file Parameter, os Parameter, Global Parameters 4508@comment node-name, next, previous, up 4509@subsection @t{osver} Parameter 4510@cindex osver Parameter 4511 4512(type=string, default to compiled in value). Same as the @code{-o} 4513option to @i{Amd}. Allows you to override the compiled-in version --- 94 unchanged lines hidden (view full) --- 4608 4609@example 4610/defaults \ 4611 wire==slip-net;opts:=intr,rsize=1024,wsize=1024 \ 4612 wire!=slip-net;opts:=intr,rsize=8192,wsize=8192 4613@end example 4614 4615@c ---------------------------------------------------------------- | 4570@c ---------------------------------------------------------------- 4571@node osver Parameter, pid_file Parameter, os Parameter, Global Parameters 4572@comment node-name, next, previous, up 4573@subsection @t{osver} Parameter 4574@cindex osver Parameter 4575 4576(type=string, default to compiled in value). Same as the @code{-o} 4577option to @i{Amd}. Allows you to override the compiled-in version --- 94 unchanged lines hidden (view full) --- 4672 4673@example 4674/defaults \ 4675 wire==slip-net;opts:=intr,rsize=1024,wsize=1024 \ 4676 wire!=slip-net;opts:=intr,rsize=8192,wsize=8192 4677@end example 4678 4679@c ---------------------------------------------------------------- |
4616@node show_statfs_entries Parameter, unmount_on_exit Parameter , selectors_on_default Parameter, Global Parameters | 4680@node show_statfs_entries Parameter, unmount_on_exit Parameter, selectors_on_default Parameter, Global Parameters |
4617@comment node-name, next, previous, up 4618@subsection @t{show_statfs_entries} Parameter 4619@cindex show_statfs_entries Parameter 4620 4621(type=boolean), default=@samp{no}). If @samp{yes}, then all maps which are 4622browsable will also show the number of entries (keys) they have when 4623@b{df}(1) runs. (This is accomplished by returning non-zero values to 4624the @b{statfs}(2) system call). 4625 4626@c ---------------------------------------------------------------- | 4681@comment node-name, next, previous, up 4682@subsection @t{show_statfs_entries} Parameter 4683@cindex show_statfs_entries Parameter 4684 4685(type=boolean), default=@samp{no}). If @samp{yes}, then all maps which are 4686browsable will also show the number of entries (keys) they have when 4687@b{df}(1) runs. (This is accomplished by returning non-zero values to 4688the @b{statfs}(2) system call). 4689 4690@c ---------------------------------------------------------------- |
4627@node unmount_on_exit Parameter, , show_statfs_entries Parameter, Global Parameters | 4691@node unmount_on_exit Parameter, vendor Parameter, show_statfs_entries Parameter, Global Parameters |
4628@comment node-name, next, previous, up 4629@subsection @t{unmount_on_exit} Parameter 4630@cindex unmount_on_exit Parameter 4631 4632(type=boolean), default=@samp{no}). If @samp{yes}, then @i{Amd} will attempt 4633to unmount all file systems which it knows about. Normally it leaves 4634all (esp. NFS) mounted file systems intact. Note that @i{Amd} does not 4635know about file systems mounted before it starts up, unless the 4636@samp{restart_mounts} option is used (@pxref{restart_mounts Parameter}). 4637 | 4692@comment node-name, next, previous, up 4693@subsection @t{unmount_on_exit} Parameter 4694@cindex unmount_on_exit Parameter 4695 4696(type=boolean), default=@samp{no}). If @samp{yes}, then @i{Amd} will attempt 4697to unmount all file systems which it knows about. Normally it leaves 4698all (esp. NFS) mounted file systems intact. Note that @i{Amd} does not 4699know about file systems mounted before it starts up, unless the 4700@samp{restart_mounts} option is used (@pxref{restart_mounts Parameter}). 4701 |
4702@c ---------------------------------------------------------------- 4703@node vendor Parameter, , unmount_on_exit Parameter, Global Parameters 4704@comment node-name, next, previous, up 4705@subsection @t{vendor} Parameter 4706@cindex vendor Parameter 4707 4708(type=string, default to compiled in value). The name of the vendor of 4709the operating system. Overrides the compiled-in vendor name. Useful 4710when the compiled-in name is not desired. For example, most Intel based 4711systems set the vendor name to @samp{unknown}, but you can set it to 4712@samp{redhat}. 4713 |
|
4638@c ================================================================ 4639@node Regular Map Parameters, amd.conf Examples, Global Parameters, Amd Configuration File 4640@comment node-name, next, previous, up 4641@section Regular Map Parameters 4642@cindex amd.conf regular map parameters 4643 4644The following parameters are applicable only to regular map sections. 4645 --- 1688 unchanged lines hidden (view full) --- 6334containing @i{linkname}, which defaults to @file{/hlfs/home}. Lookups 6335within that directory are handled by @i{Hlfsd}, which uses the 6336password map to determine how to resolve the lookup. The directory will 6337be created if it doesn't already exist. The symbolic link will be to 6338the accessing user's home directory, with @i{subdir} appended to it. If 6339not specified, @i{subdir} defaults to @file{.hlfsdir}. This directory 6340will also be created if it does not already exist. 6341 | 4714@c ================================================================ 4715@node Regular Map Parameters, amd.conf Examples, Global Parameters, Amd Configuration File 4716@comment node-name, next, previous, up 4717@section Regular Map Parameters 4718@cindex amd.conf regular map parameters 4719 4720The following parameters are applicable only to regular map sections. 4721 --- 1688 unchanged lines hidden (view full) --- 6410containing @i{linkname}, which defaults to @file{/hlfs/home}. Lookups 6411within that directory are handled by @i{Hlfsd}, which uses the 6412password map to determine how to resolve the lookup. The directory will 6413be created if it doesn't already exist. The symbolic link will be to 6414the accessing user's home directory, with @i{subdir} appended to it. If 6415not specified, @i{subdir} defaults to @file{.hlfsdir}. This directory 6416will also be created if it does not already exist. 6417 |
6342A @samp{SIGTERM} sent to @i{Hlfsd} will cause it to shutdown. A @samp{SIGHUP} will 6343flush the internal caches, and reload the password map. It will also 6344close and reopen the log file, to enable the original log file to be 6345removed or rotated. A @samp{SIGUSR1} will cause it to dump its internal table 6346of user IDs and home directories to the file @file{/tmp/hlfsddump}. | 6418A @samp{SIGTERM} sent to @i{Hlfsd} will cause it to shutdown. A 6419@samp{SIGHUP} will flush the internal caches, and reload the password 6420map. It will also close and reopen the log file, to enable the original 6421log file to be removed or rotated. A @samp{SIGUSR1} will cause it to 6422dump its internal table of user IDs and home directories to the file 6423@file{/tmp/hlfsddump}. |
6347 6348@menu 6349* Introduction to Hlfsd:: 6350* Background to Mail Delivery:: 6351* Using Hlfsd:: 6352@end menu 6353 6354@c ================================================================ --- 1703 unchanged lines hidden (view full) --- 8058@c LocalWords: maxmem hlfsdir xmailbox showmount cn amdmap amdmapName resvport 8059@c LocalWords: objectClass amdmapKey amdmapValue ln powerpc amdmapTimestamp ez 8060@c LocalWords: moisil FSinfo Libtool Unmounting sublink fileservers NullProc 8061@c LocalWords: gethostname mount's unmounts linkx remounts unmounting UAs SA's 8062@c LocalWords: mountpoint mountpoints unescaped UIDs util's overlayed uref EFS 8063@c LocalWords: serv maxgroups nfsl cachedir copt cfsadmin efs addopts fg ROMs 8064@c LocalWords: nointr extatt setchapternewpage columnfractions alphaev gnulibc 8065@c LocalWords: freebsdelf gnuoldld ifhtml defperm nodefperm norrip RRIP rrip | 6424 6425@menu 6426* Introduction to Hlfsd:: 6427* Background to Mail Delivery:: 6428* Using Hlfsd:: 6429@end menu 6430 6431@c ================================================================ --- 1703 unchanged lines hidden (view full) --- 8135@c LocalWords: maxmem hlfsdir xmailbox showmount cn amdmap amdmapName resvport 8136@c LocalWords: objectClass amdmapKey amdmapValue ln powerpc amdmapTimestamp ez 8137@c LocalWords: moisil FSinfo Libtool Unmounting sublink fileservers NullProc 8138@c LocalWords: gethostname mount's unmounts linkx remounts unmounting UAs SA's 8139@c LocalWords: mountpoint mountpoints unescaped UIDs util's overlayed uref EFS 8140@c LocalWords: serv maxgroups nfsl cachedir copt cfsadmin efs addopts fg ROMs 8141@c LocalWords: nointr extatt setchapternewpage columnfractions alphaev gnulibc 8142@c LocalWords: freebsdelf gnuoldld ifhtml defperm nodefperm norrip RRIP rrip |
8066@c LocalWords: noversion attr XXXXXX netgrpd | 8143@c LocalWords: noversion attr XXXXXX netgrpd rh mkstemp |