| nscd.8 (158192) | nscd.8 (162893) |
|---|---|
| 1.\" Copyright (c) 2005 Michael Bushkov <bushman@rsu.ru> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 2005 Michael Bushkov <bushman@rsu.ru> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
| 25.\" $FreeBSD: head/usr.sbin/nscd/nscd.8 158192 2006-04-30 21:31:52Z maxim $ | 25.\" $FreeBSD: head/usr.sbin/nscd/nscd.8 162893 2006-09-30 19:07:03Z ru $ |
| 26.\" 27.Dd October 20, 2005 28.Dt CACHED 8 29.Os 30.Sh NAME 31.Nm cached 32.Nd "caching server daemon" 33.Sh SYNOPSIS 34.Nm | 26.\" 27.Dd October 20, 2005 28.Dt CACHED 8 29.Os 30.Sh NAME 31.Nm cached 32.Nd "caching server daemon" 33.Sh SYNOPSIS 34.Nm |
| 35.Op Fl nst | 35.Op Fl dnst |
| 36.Op Fl i Ar cachename 37.Op Fl I Ar cachename 38.Sh DESCRIPTION | 36.Op Fl i Ar cachename 37.Op Fl I Ar cachename 38.Sh DESCRIPTION |
| 39The |
|
| 39.Nm | 40.Nm |
| 41utility |
|
| 40is the system caching daemon. 41It can cache almost all types of data and is basically intended to be used 42with the | 42is the system caching daemon. 43It can cache almost all types of data and is basically intended to be used 44with the |
| 43.Pa nsswitch | 45.Nm nsswitch |
| 44subsystem. 45The cache is actually per-user. 46This means that each user can work only with the 47cached data that were cached by themselves, and cannot poison the 48cache of other users. 49The 50.Nm 51utility supports two types of caching: | 46subsystem. 47The cache is actually per-user. 48This means that each user can work only with the 49cached data that were cached by themselves, and cannot poison the 50cache of other users. 51The 52.Nm 53utility supports two types of caching: |
| 52.Bl -tag -width Pair | 54.Bl -tag -width ".Sy Type" |
| 53.It Sy Type 54.Sy Description 55.It Common caching | 55.It Sy Type 56.Sy Description 57.It Common caching |
| 56Each cached element is the the key+value pair. | 58Each cached element is the key+value pair. |
| 57This type of caching supports policies which are applied when maximum 58number of cached elements is exceeded. 59Three policies are available: | 59This type of caching supports policies which are applied when maximum 60number of cached elements is exceeded. 61Three policies are available: |
| 60.Pa FIFO | 62.Cm FIFO |
| 61(first in - first out), | 63(first in - first out), |
| 62.Pa LRU | 64.Cm LRU |
| 63(least recently used) and | 65(least recently used) and |
| 64.Pa LFU | 66.Cm LFU |
| 65(least frequently used). 66This type of caching is used with the 67.Fn getXXXbyname 68family of functions. 69.It Multipart caching 70Each cached element is the part of the elements sequence. 71This type of caching is intended to be used with the 72.Fn getXXXent 73family of functions. 74.El 75.Pp 76The 77.Nm 78utility is able not only to cache elements, but to perform the actual nsswitch 79lookups by itself. | 67(least frequently used). 68This type of caching is used with the 69.Fn getXXXbyname 70family of functions. 71.It Multipart caching 72Each cached element is the part of the elements sequence. 73This type of caching is intended to be used with the 74.Fn getXXXent 75family of functions. 76.El 77.Pp 78The 79.Nm 80utility is able not only to cache elements, but to perform the actual nsswitch 81lookups by itself. |
| 80To enable this feature use the 81.Pa perform-actual-lookups 82parameter in the 83.Xr cached.conf 5 | 82To enable this feature, use the 83.Va perform-actual-lookups 84parameter in 85.Xr cached.conf 5 . |
| 84.Pp 85The 86.Nm 87utility recognizes the following runtime options: 88.Bl -tag -width indent | 86.Pp 87The 88.Nm 89utility recognizes the following runtime options: 90.Bl -tag -width indent |
| 91.\" .It Fl d 92.\" XXX Document me! |
|
| 89.It Fl n | 93.It Fl n |
| 90Do not daemonize. | 94Do not daemonize; |
| 91.Nm 92will not fork or disconnect itself from the terminal. 93.It Fl s 94Single-threaded mode. 95Forces using only one thread for all processing purposes (it overrides 96the | 95.Nm 96will not fork or disconnect itself from the terminal. 97.It Fl s 98Single-threaded mode. 99Forces using only one thread for all processing purposes (it overrides 100the |
| 97.Pa threads | 101.Va threads |
| 98parameter in the 99.Xr cached.conf 5 100file). 101.It Fl t 102Trace mode. 103All trace messages will be written to stdout. 104This mode is usually used with 105.Fl n --- 5 unchanged lines hidden (view full) --- 111When specified, 112.Nm 113acts as the administration tool. 114It asks the already running 115.Nm 116to invalidate the specified part of the cache of the 117calling user. 118For example, sometimes you may want to invalidate your | 102parameter in the 103.Xr cached.conf 5 104file). 105.It Fl t 106Trace mode. 107All trace messages will be written to stdout. 108This mode is usually used with 109.Fl n --- 5 unchanged lines hidden (view full) --- 115When specified, 116.Nm 117acts as the administration tool. 118It asks the already running 119.Nm 120to invalidate the specified part of the cache of the 121calling user. 122For example, sometimes you may want to invalidate your |
| 119.Pa hosts | 123.Dq Li hosts |
| 120cache. 121You can specify | 124cache. 125You can specify |
| 122.Pa all | 126.Dq Li all |
| 123as the | 127as the |
| 124.Pa cachename | 128.Ar cachename |
| 125to invalidate your personal cache as a whole. | 129to invalidate your personal cache as a whole. |
| 126You cannot use this option for the cachename, for which 127the 128.Pa perform-actual-lookups | 130You cannot use this option for the 131.Ar cachename 132for which the 133.Va perform-actual-lookups |
| 129option is enabled. 130.It Fl I Ar cachename 131Invalidates the cache for every user. 132When specified, 133.Nm 134acts as the administration tool. 135It asks the already 136running 137.Nm 138to invalidate the specified part of the cache for 139every user. 140You can specify | 134option is enabled. 135.It Fl I Ar cachename 136Invalidates the cache for every user. 137When specified, 138.Nm 139acts as the administration tool. 140It asks the already 141running 142.Nm 143to invalidate the specified part of the cache for 144every user. 145You can specify |
| 141.Pa all | 146.Dq Li all |
| 142as the | 147as the |
| 143.Pa cachename | 148.Ar cachename |
| 144to invalidate the whole cache. 145Only the root can use this option. 146.El 147.Sh FILES | 149to invalidate the whole cache. 150Only the root can use this option. 151.El 152.Sh FILES |
| 148.Bl -tag -width /etc/cached.conf -compact | 153.Bl -tag -width ".Pa /etc/cached.conf" -compact |
| 149.It Pa /etc/cached.conf 150The default configuration file. 151.El 152.Sh SEE ALSO 153.Xr nsdispatch 3 , 154.Xr cached.conf 5 , 155.Xr nsswitch.conf 5 | 154.It Pa /etc/cached.conf 155The default configuration file. 156.El 157.Sh SEE ALSO 158.Xr nsdispatch 3 , 159.Xr cached.conf 5 , 160.Xr nsswitch.conf 5 |
| 156.Sh "AUTHORS" | 161.Sh AUTHORS |
| 157.An Michael Bushkov Aq bushman@rsu.ru | 162.An Michael Bushkov Aq bushman@rsu.ru |
| 158.Sh "BUGS" 159To report bugs or suggestions please mail me: 160.Aq bushman@rsu.ru | 163.Sh BUGS 164Please send bug reports and suggestions to 165.Aq bushman@rsu.ru . |