author | Mike Sullivan <Mike.Sullivan@Oracle.COM> |
Thu, 20 Mar 2014 16:14:03 -0700 | |
changeset 1775 | 221ebe7e8513 |
parent 223 | b9246653129d |
permissions | -rw-r--r-- |
223
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
1 |
'\" te |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
2 |
.TH memcached 1M "March 2008" "SunOS 5.11" "Administration Commands" |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
3 |
.SH NAME |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
4 |
memcached \- high performance memory object caching |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
5 |
system |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
6 |
.SH SYNOPSIS |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
7 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
8 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
9 |
\fBmemcached [\fB-l\fR \fI<ip-addr>\fR] [\fB-d\fR] [\fB-u\fR \fI<username>\fR] |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
10 |
[\fB-m\fR \fI<num>\fR] [\fB-c\fR \fI<num>\fR] [\fB-k\fR] [\fB-L \fR] |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
11 |
[\fB-p\fR \fI<num>\fR] [\fB-U\fR \fI<num>\fR] [\fB-s\fR \fI<filename>\fR] |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
12 |
[\fB-a\fR \fI<perms>\fR] [\fB-M\fR] [\fB-r\fR] [\fB-b\fR] |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
13 |
[\fB-f\fR \fI<factor>\fR] [\fB-n\fR \fI<size>\fR] [\fB-h\fR] [\fB-v\fR] [\fB-vv\fR] [\fB-i\fR] |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
14 |
[\fB-P\fR \fI<filename>\fR] [\fB-t\fR \fI<threads>\fR] [\fB-D\fR \fI<char>\fR]\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
15 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
16 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
17 |
.SH DESCRIPTION |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
18 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
19 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
20 |
\fBmemcached\fR is a flexible memory object caching daemon |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
21 |
designed to alleviate database load in dynamic web applications by storing |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
22 |
objects in memory. It is based on \fBlibevent\fR to scale to |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
23 |
any size needed, and is specifically optimized to avoid swapping and always |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
24 |
use non-blocking I/O. This man page documents briefly the \fBmemcached\fR memory |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
25 |
object caching daemon. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
26 |
.SH OPTIONS |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
27 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
28 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
29 |
The options supported by the \fBmemcached\fR command are |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
30 |
described below. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
31 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
32 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
33 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
34 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
35 |
\fB\fB-l\fR \fI<ip-addr>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
36 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
37 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
38 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
39 |
Listen on \fI<ip-addr>\fR; default |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
40 |
to \fBINADDR_ANY\fR. This is an important option to consider |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
41 |
as there is no other way to secure the installation. Binding to an internal |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
42 |
or fire walled network interface is suggested. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
43 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
44 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
45 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
46 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
47 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
48 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
49 |
\fB\fB-d\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
50 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
51 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
52 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
53 |
Run memcached as a daemon. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
54 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
55 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
56 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
57 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
58 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
59 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
60 |
\fB\fB-u\fR \fI<username>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
61 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
62 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
63 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
64 |
Assume the identity of \fI<username>\fR only when run as a super user (root). |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
65 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
66 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
67 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
68 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
69 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
70 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
71 |
\fB\fB-m\fR \fI<num>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
72 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
73 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
74 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
75 |
Use the maximum \fI<num>\fR MB memory for object storage; the default is 64 MB. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
76 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
77 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
78 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
79 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
80 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
81 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
82 |
\fB\fB-c\fR \fI<num>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
83 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
84 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
85 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
86 |
Use the specified number of maximum simultaneous connections; |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
87 |
the default is 1024. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
88 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
89 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
90 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
91 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
92 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
93 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
94 |
\fB\fB-k\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
95 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
96 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
97 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
98 |
Lock down all paged memory. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
99 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
100 |
Use this option with caution with large caches. For information about |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
101 |
the configuration suggestions, see the README and the memcached home page. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
102 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
103 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
104 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
105 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
106 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
107 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
108 |
\fB\fB-L\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
109 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
110 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
111 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
112 |
Preallocate memory and use large memory pages if possible. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
113 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
114 |
This option will preallocate cache memory for object storage. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
115 |
See description of \fB-m\fR option for a specification of the size of the memory. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
116 |
If supported by the platform, large memory pages will be allocated. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
117 |
This should reduce number of TLB misses and increase performance. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
118 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
119 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
120 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
121 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
122 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
123 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
124 |
\fB\fB-p\fR \fI<num>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
125 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
126 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
127 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
128 |
Listen on the TCP port \fI<num>\fR\&. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
129 |
The default port is 11211. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
130 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
131 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
132 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
133 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
134 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
135 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
136 |
\fB\fB-U\fR \fI<num>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
137 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
138 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
139 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
140 |
Listen on the UDP port \fI<num>\fR\&. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
141 |
The default is 0, meaning that the UDP protocol is disabled. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
142 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
143 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
144 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
145 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
146 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
147 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
148 |
\fB\fB-s\fR \fI<filename>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
149 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
150 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
151 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
152 |
Unix socket path to listen on (disables listening support for TCP and UDP). |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
153 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
154 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
155 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
156 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
157 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
158 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
159 |
\fB\fB-a\fR \fI<perms>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
160 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
161 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
162 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
163 |
Permissions (in octal format) for Unix socket created with \fB-s\fR option. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
164 |
Default value is 0700. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
165 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
166 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
167 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
168 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
169 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
170 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
171 |
\fB\fB-M\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
172 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
173 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
174 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
175 |
Disable automatic removal of items from the cache when out |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
176 |
of memory. Additions will not be possible until adequate space is freed up. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
177 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
178 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
179 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
180 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
181 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
182 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
183 |
\fB\fB-r\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
184 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
185 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
186 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
187 |
Raise the core file size limit to the maximum allowable. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
188 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
189 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
190 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
191 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
192 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
193 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
194 |
\fB\fB-b\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
195 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
196 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
197 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
198 |
Run a managed instance. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
199 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
200 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
201 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
202 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
203 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
204 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
205 |
\fB\fB-f\fR \fI<factor>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
206 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
207 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
208 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
209 |
Use this option to specify \fI<factor>\fR as |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
210 |
the multiplier for computing the sizes of memory chunks that items are stored |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
211 |
in. A lower value may result in less wasted memory depending on the total |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
212 |
amount of memory available and the distribution of item sizes. The default |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
213 |
value is 1.25. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
214 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
215 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
216 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
217 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
218 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
219 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
220 |
\fB\fB-n\fR \fI<size>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
221 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
222 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
223 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
224 |
Allocate a minimum of \fI<size>\fR bytes |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
225 |
for the item key, value, and flags. The default value is 48. If you have a |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
226 |
lot of small keys and values, you can get a significant memory efficiency |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
227 |
gain with a lower value. If you use a high chunk growth factor, that is \fB-f\fR option, you may want to increase the size to allow a bigger percentage |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
228 |
of your items to fit in the most densely packed smallest chunks. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
229 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
230 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
231 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
232 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
233 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
234 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
235 |
\fB\fB-h\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
236 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
237 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
238 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
239 |
Show the version of memcached and a summary of options. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
240 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
241 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
242 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
243 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
244 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
245 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
246 |
\fB\fB-v\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
247 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
248 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
249 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
250 |
Be verbose during the event loop; print out errors and warnings. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
251 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
252 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
253 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
254 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
255 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
256 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
257 |
\fB\fB-vv\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
258 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
259 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
260 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
261 |
Be even more verbose; same as \fB-v\fR option but |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
262 |
also print client commands and responses. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
263 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
264 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
265 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
266 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
267 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
268 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
269 |
\fB\fB-i\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
270 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
271 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
272 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
273 |
Display \fBmemcached\fR and \fBlibevent\fR licenses. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
274 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
275 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
276 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
277 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
278 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
279 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
280 |
\fB\fB-P\fR \fI<filename>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
281 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
282 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
283 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
284 |
Print \fBpidfile\fR to the specified file. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
285 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
286 |
Note - |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
287 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
288 |
.RS 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
289 |
This option can be used only when \fBmechached\fR is |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
290 |
run as a daemon (\fB-d\fR option). |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
291 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
292 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
293 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
294 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
295 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
296 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
297 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
298 |
\fB\fB-t\fR \fI<threads>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
299 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
300 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
301 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
302 |
Number of threads to use to process incoming requests. The default is 4. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
303 |
It is typically not useful to set this much higher than the number of CPU cores |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
304 |
on the \fBmemcached\fR server. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
305 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
306 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
307 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
308 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
309 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
310 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
311 |
\fB\fB-D\fR \fI<char>\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
312 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
313 |
.RS 17n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
314 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
315 |
Use the \fI<char>\fR as the delimiter |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
316 |
between key prefixes and IDs. This is used for per-prefix statistics reporting. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
317 |
The default is \fB:\fR (colon). If this option is specified, |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
318 |
statistics collection is turned on automatically; if not, then it can be turned |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
319 |
on by sending the \fBstats detail on\fR command to the server. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
320 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
321 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
322 |
.SH EXIT STATUS |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
323 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
324 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
325 |
The following exit values are returned: |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
326 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
327 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
328 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
329 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
330 |
\fB\fB0\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
331 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
332 |
.RS 5n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
333 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
334 |
command executed successfully |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
335 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
336 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
337 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
338 |
.ne 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
339 |
.mk |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
340 |
.na |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
341 |
\fB\fB1\fR\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
342 |
.ad |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
343 |
.RS 5n |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
344 |
.rt |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
345 |
error in executing the command |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
346 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
347 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
348 |
.SH SERVICE MANAGEMENT FACILITY |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
349 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
350 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
351 |
\fBmemcached\fR package for Solaris (\fBservice/memcached\fR) |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
352 |
includes files necessary to register with the Service Management Facility |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
353 |
described in \fISMF(5)\fR. The following procedure describes the steps to automate |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
354 |
the service management using memcached. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
355 |
.RS +4 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
356 |
.TP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
357 |
1. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
358 |
Add other parameters to be passed to the memcached service instance. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
359 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
360 |
example: specify the server to use 1024 MB of memory |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
361 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
362 |
.in +2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
363 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
364 |
example% svccfg |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
365 |
svc:> select memcached |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
366 |
svc:/application/database/memcached> setprop memcached/options=("-m" "1024") |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
367 |
svc:/application/database/memcached> quit |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
368 |
example% svcadm refresh memcached |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
369 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
370 |
.in -2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
371 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
372 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
373 |
Note - |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
374 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
375 |
.RS 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
376 |
The arguments cannot be passed as a single string because of a limitation in \fIsvccfg\fR. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
377 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
378 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
379 |
.RS +4 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
380 |
.TP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
381 |
2. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
382 |
Enable memcached . |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
383 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
384 |
.in +2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
385 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
386 |
example% svcadm enable memcached |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
387 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
388 |
.in -2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
389 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
390 |
The state of the service instance changes to \fBonline\fR, |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
391 |
and the memcached service instance must be started: |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
392 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
393 |
.in +2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
394 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
395 |
example% svcs memcached |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
396 |
STATE STIME FMRI |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
397 |
online 1:19:15 svc:/application/database/memcached:default |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
398 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
399 |
.in -2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
400 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
401 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
402 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
403 |
.RS +4 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
404 |
.TP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
405 |
3. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
406 |
To disable shutdown and automatic restart of memcached service instance, |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
407 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
408 |
.in +2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
409 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
410 |
example% svcadm disable memcached |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
411 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
412 |
.in -2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
413 |
|
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
414 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
415 |
.SH USER AUTHORIZATIONS |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
416 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
417 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
418 |
You can use \fBRBAC(5)\fR to authorize otherwise non-privileged users to manage |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
419 |
\fBmemcached\fR services. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
420 |
To let a user named \fBmyuser\fR change \fBmemcached\fR value properties and |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
421 |
manage \fBmemcached\fR service states, add the following line to |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
422 |
\fB/etc/user_attr\fR: |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
423 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
424 |
.in +2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
425 |
.nf |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
426 |
myuser::::type=role;profiles=Memcached Administration,All |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
427 |
.fi |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
428 |
.in -2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
429 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
430 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
431 |
.SH PACKAGE CONTENTS |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
432 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
433 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
434 |
The \fBmemcached\fR package consists of the memcached server and |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
435 |
man pages for the server. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
436 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
437 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
438 |
Client libraries can be made available by installing other packages. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
439 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
440 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
441 |
The memcached server is based on the memcached open-source software |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
442 |
available from http://www.danga.com/memcached/\&. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
443 |
.SH SECURITY |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
444 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
445 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
446 |
When the memcached server is started, it listens for network requests |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
447 |
on a TCP port and/or a UDP port. It is important for the security of the network |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
448 |
that you protect this port, for example, by blocking access to this port in |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
449 |
a firewall. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
450 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
451 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
452 |
The default TCP port number to use is 11211. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
453 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
454 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
455 |
You may use the \fB-p\fR option to set another TCP port number. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
456 |
There is no default UDP port number. You can use the \fB-U\fR option |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
457 |
to set a UDP port number. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
458 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
459 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
460 |
If you are running memcached on a server with multiple network interfaces, |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
461 |
you can restrict vulnerability by binding memcached to a single interface |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
462 |
by using the \fB-l\fR option. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
463 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
464 |
Caution - |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
465 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
466 |
.RS 2 |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
467 |
Note that \fBmemcached\fR was designed for speed |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
468 |
and not for security. There is no authentication of requests that go in to |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
469 |
the memcached servers, and communication is not encrypted. The network that |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
470 |
your memcached servers and clients run within should be safe-guarded against |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
471 |
network attacks. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
472 |
.RE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
473 |
.SH SEE ALSO |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
474 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
475 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
476 |
\fBlibmemcached(3libmemcached)\fR |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
477 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
478 |
Additional documentation (FAQ) can be found at http://www.eu.socialtext.net/memcached/index.cgi\&. |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
479 |
.SH NOTES |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
480 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
481 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
482 |
LICENSE |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
483 |
.sp |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
484 |
.LP |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
485 |
The \fBmemcached\fR daemon is copyright Danga Interactive |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
486 |
and is distributed under the BSD license. \fBmemcached\fR clients |
b9246653129d
7043529 move memcached to userland
Mike Sullivan <Mike.Sullivan@Oracle.COM>
parents:
diff
changeset
|
487 |
are licensed separately. |