| nscd.8 (158115) | nscd.8 (158135) |
|---|---|
| 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 158115 2006-04-28 12:03:38Z ume $ | 25.\" $FreeBSD: head/usr.sbin/nscd/nscd.8 158135 2006-04-29 01:34:03Z trhodes $ |
| 26.\" | 26.\" |
| 27 | |
| 28.Dd October 20, 2005 29.Dt CACHED 8 30.Os 31.Sh NAME 32.Nm cached | 27.Dd October 20, 2005 28.Dt CACHED 8 29.Os 30.Sh NAME 31.Nm cached |
| 33.Nd caching server daemon | 32.Nd "caching server daemon" |
| 34.Sh SYNOPSIS 35.Nm 36.Op Fl nst 37.Op Fl i Ar cachename 38.Op Fl I Ar cachename 39.Sh DESCRIPTION 40.Nm | 33.Sh SYNOPSIS 34.Nm 35.Op Fl nst 36.Op Fl i Ar cachename 37.Op Fl I Ar cachename 38.Sh DESCRIPTION 39.Nm |
| 41- is the system caching daemon. | 40is the system caching daemon. |
| 42It can cache almost all types of data and is basically intended to be used | 41It can cache almost all types of data and is basically intended to be used |
| 43with | 42with the |
| 44.Pa nsswitch 45subsystem. | 43.Pa nsswitch 44subsystem. |
| 46The cache is actually per-user. It means that each user can work only with the 47cached data, that were cached by him and can't poison the cache of other users. | 45The cache is actually per-user. 46This means that each user can work only with the 47cached data that was cached locally and cannot poison the cache of other users. 48The |
| 48.Nm | 49.Nm |
| 49supports 2 types of caching: | 50utility supports two types of caching: |
| 50.Bl -tag -width Pair 51.It Sy Type 52.Sy Description 53.It Common caching 54Each cached element is the the key+value pair. | 51.Bl -tag -width Pair 52.It Sy Type 53.Sy Description 54.It Common caching 55Each cached element is the the key+value pair. |
| 55This type of caching supports policies, which are applied, when maximum | 56This type of caching supports policies which are applied when maximum |
| 56number of cached elements is exceeded. | 57number of cached elements is exceeded. |
| 573 policies are available: | 58Three policies are available: |
| 58.Pa FIFO 59(first in - first out), 60.Pa LRU 61(least recently used) and 62.Pa LFU 63(least frequently used). | 59.Pa FIFO 60(first in - first out), 61.Pa LRU 62(least recently used) and 63.Pa LFU 64(least frequently used). |
| 64This type of caching is used with | 65This type of caching is used with the |
| 65.Fn getXXXbyname | 66.Fn getXXXbyname |
| 66- like functions. | 67family of functions. |
| 67.It Multipart caching 68Each cached element is the part of the elements sequence. | 68.It Multipart caching 69Each cached element is the part of the elements sequence. |
| 69This type of caching is intended to be used with | 70This type of caching is intended to be used with the |
| 70.Fn getXXXent | 71.Fn getXXXent |
| 71- like functions. | 72family of functions. |
| 72.El 73.Pp | 73.El 74.Pp |
| 75The |
|
| 74.Nm | 76.Nm |
| 75is able not only to cache elements, but to perform the actual nsswitch 76lookups by itself. To enable this feature use | 77utility is able not only to cache elements, but to perform the actual nsswitch 78lookups by itself. 79To enable this feature use the |
| 77.Pa perform-actual-lookups 78parameter in the 79.Xr cached.conf 5 80.Pp | 80.Pa perform-actual-lookups 81parameter in the 82.Xr cached.conf 5 83.Pp |
| 84The |
|
| 81.Nm | 85.Nm |
| 82recognizes the following runtime options: | 86utility recognizes the following runtime options: |
| 83.Bl -tag -width indent 84.It Fl n 85Do not daemonize. 86.Nm | 87.Bl -tag -width indent 88.It Fl n 89Do not daemonize. 90.Nm |
| 87doesn't fork and doesn't disconnect itself from the terminal. | 91will not fork or disconnect itself from the terminal. |
| 88.It Fl s 89Single-threaded mode. 90Forces using only one thread for all processing purposes (it overrides 91the 92.Pa threads 93parameter in the 94.Xr cached.conf 5 95file). 96.It Fl t 97Trace mode. | 92.It Fl s 93Single-threaded mode. 94Forces using only one thread for all processing purposes (it overrides 95the 96.Pa threads 97parameter in the 98.Xr cached.conf 5 99file). 100.It Fl t 101Trace mode. |
| 98All trace messages would be written to the stdout. | 102All trace messages will be written to stdout. |
| 99This mode is usually used with 100.Fl n 101and 102.Fl s | 103This mode is usually used with 104.Fl n 105and 106.Fl s |
| 103flags for debugging purposes. | 107flags are used for debugging purposes. |
| 104.It Fl i Ar cachename | 108.It Fl i Ar cachename |
| 105Invalidates personal cache. When specified, | 109Invalidates personal cache. 110When specified, |
| 106.Nm | 111.Nm |
| 107acts as the administration tool. It asks the already 108running | 112acts as the administration tool. 113It asks the already running |
| 109.Nm 110to invalidate the specified part of the cache of the | 114.Nm 115to invalidate the specified part of the cache of the |
| 111calling user. For example, you may want sometimes 112to invalidate your | 116calling user. 117For example, sometimes you may want to invalidate your |
| 113.Pa hosts | 118.Pa hosts |
| 114cache. You can specify | 119cache. 120You can specify |
| 115.Pa all 116as the 117.Pa cachename | 121.Pa all 122as the 123.Pa cachename |
| 118to invalidate your personal cache as a whole. You 119can't use this option for the cachename, for which | 124to invalidate your personal cache as a whole. 125You cannot use this option for the cachename, for which |
| 120the 121.Pa perform-actual-lookups 122option is enabled. 123.It Fl I Ar cachename | 126the 127.Pa perform-actual-lookups 128option is enabled. 129.It Fl I Ar cachename |
| 124Invalidates the cache for every user. When specified, | 130Invalidates the cache for every user. 131When specified, |
| 125.Nm | 132.Nm |
| 126acts as the administration tool. It asks the already | 133acts as the administration tool. 134It asks the already |
| 127running 128.Nm 129to invalidate the specified part of the cache for | 135running 136.Nm 137to invalidate the specified part of the cache for |
| 130every user. You can specify | 138every user. 139You can specify |
| 131.Pa all 132as the 133.Pa cachename | 140.Pa all 141as the 142.Pa cachename |
| 134to invalidate the whole cache. Only root can use this 135option. | 143to invalidate the whole cache. 144Only the root can use this option. |
| 136.El 137.Sh FILES 138.Xr cached.conf 5 139.Sh SEE ALSO 140.Xr cached.conf 5 141.Xr nsswitch.conf 5 142.Xr nsdispatch 3 143.Sh "AUTHORS" | 145.El 146.Sh FILES 147.Xr cached.conf 5 148.Sh SEE ALSO 149.Xr cached.conf 5 150.Xr nsswitch.conf 5 151.Xr nsdispatch 3 152.Sh "AUTHORS" |
| 144Michael Bushkov 145.Aq bushman@rsu.ru | 153.An Michael Bushkov Aq bushman@rsu.ru |
| 146.Sh "BUGS" | 154.Sh "BUGS" |
| 147To report bugs or suggestions please mail me | 155To report bugs or suggestions please mail me: |
| 148.Aq bushman@rsu.ru | 156.Aq bushman@rsu.ru |