components/web/lighttpd/Solaris/lighttpd.1m.sunman

   1 '\" t
   2 .\"
   3 .\" CDDL HEADER START
   4 .\"
   5 .\" The contents of this file are subject to the terms of the
   6 .\" Common Development and Distribution License (the "License").
   7 .\" You may not use this file except in compliance with the License.
   8 .\"
   9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10 .\" or http://www.opensolaris.org/os/licensing.
  11 .\" See the License for the specific language governing permissions
  12 .\" and limitations under the License.
  13 .\"
  14 .\" When distributing Covered Code, include this CDDL HEADER in each
  15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16 .\" If applicable, add the following below this CDDL HEADER, with the
  17 .\" fields enclosed by brackets "[]" replaced with your own identifying
  18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  19 .\"
  20 .\" CDDL HEADER END
  21 .\"
  22 .\" Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.
  23 .\"
  24 .TH lighttpd 1M "October 2009" "SunOS 5.11" "System Administration Commands"
  25 .SH NAME
  26 lighttpd \- a fast, secure and flexible webserver
  27 .SH SYNOPSIS
  28 .LP
  29 .nf
  30 \fBlighttpd\fR
  31 .fi
  32
  33 .SH DESCRIPTION
  34 .sp
  35 .LP
  36 The Lighttpd Web Server consists of a server daemon,  a watchdog process, loadable server modules, configuration files and documentation.
  37 .sp
  38 .LP
  39 .SH FILES
  40 .sp
  41 .LP
  42 The following paths specify the installation locations for Lighttpd:
  43 .LP
  44 Note :
  45 .RS +4
  46 .TP
  47 .ie t \(bu
  48 .el o
  49 The string \fB[version]\fR should be expanded
  50 to \fB"MAJOR.MINOR"\fR. For example, \fB/usr/lighttpd/1.4/*\fR.
  51 .RE
  52 .RE
  53 .sp
  54 .ne 2
  55 .mk
  56 .na
  57 \fB\fB/etc/lighttpd/[version]\fR\fR
  58 .ad
  59 .sp .6
  60 .RS 4n
  61 Contains lighttpd configuration files. A new install contains a single, default configuration file \fBlighttpd.conf\fR.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .mk
  67 .na
  68 \fB\fB/etc/lighttpd/[version]/conf.d\fR\fR
  69 .ad
  70 .sp .6
  71 .RS 4n
  72 Contains additional server configuration files. These files generally require some customisation and are therefore not automatically loaded by the main configuration file.
  73 .sp
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .mk
  79 .na
  80 \fB\fB/usr/lighttpd/[version]/sbin\fR\fR
  81 .ad
  82 .sp .6
  83 .RS 4n
  84 Contains the lighttpd executable and the lighttpd-angel watchdog process.
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .mk
  90 .na
  91 \fB\fB/usr/lighttpd/[version]/man\fR\fR
  92 .ad
  93 .sp .6
  94 .RS 4n
  95 Contains man pages for the server and utility programs.
  96 .sp
  97 Add this directory to your MANPATH to read the Lighttpd man pages. See
  98 Notes.
  99 .RE
 100
 101 .sp
 102 .ne 2
 103 .mk
 104 .na
 105 \fB\fB/usr/lighttpd/[version]/lib\fR\fR
 106 .ad
 107 .sp .6
 108 .RS 4n
 109 Contains the Lighttpd loadable modules. These can be loaded by using directives in the configuration file.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .mk
 115 .na
 116 \fB\fB/var/lighttpd/[version]/docroot\fR\fR
 117 .ad
 118 .sp .6
 119 .RS 4n
 120 The default location for content as specified by the server.document-root directive in the Lightpd configuration file.
 121 .RE
 122
 123 .sp
 124 .ne 2
 125 .mk
 126 .na
 127 \fB\fB/var/lighttpd/[version]/logs\fR\fR
 128 .ad
 129 .sp .6
 130 .RS 4n
 131 This is the default location for the Lighttpd log files.
 132 .sp
 133 The formats, names, and locations of the files in this directory can
 134 be altered by various configuration directives in the \fBlighttpd.conf\fR file.
 135 .RE
 136
 137 .SH SERVICE MANAGEMENT FACILITY
 138 .sp
 139 .LP
 140 The \fBlighttpd14\fR package for Solaris (\fBweb/server/lighttpd-14\fR) includes all of the files necessary to register Lighttpd with the Service Management Facility described in \fISMF(5)\fR. The following procedure describes the steps to automate service management for lighttpd.
 141
 142 Note :
 143 .RS +4
 144 .TP
 145 .ie t \(bu
 146 .el o
 147 The the full name of the lighttpd service is svc:/network/http:lighttpd14
 148 This can be abbreviated to lighttpd14 which is the \fBinstance name\fR of the service.
 149 .RE
 150
 151 .RS +4
 152 .TP
 153 1.
 154 To enable the lighttpd14 service.
 155 .sp
 156 .in +2
 157 .nf
 158 example% svcadm enable lighttpd14
 159 .fi
 160 .in -2
 161
 162 The state of the service instance changes to \fBonline\fR,
 163 and the lighttpd14 service instance is now available:
 164 .sp
 165 .in +2
 166 .nf
 167 example% svcs lighttpd14
 168 STATE          STIME    FMRI
 169 online         11:22:17 svc:/network/http:lighttpd14
 170 .fi
 171 .in -2
 172 .sp
 173
 174 .RE
 175 .RS +4
 176 .TP
 177 2.
 178 To disable the lighttpd14 service instance,
 179 .sp
 180 .in +2
 181 .nf
 182 example% svcadm disable lighttpd14
 183 .fi
 184 .in -2
 185
 186 The state of the service instance changes to \fBdisabled\fR,
 187 and the lighttpd service instance is no longer available:
 188 .sp
 189 .in +2
 190 .nf
 191 example% svcs lighttpd14
 192 STATE          STIME    FMRI
 193 disabled       11:35:15 svc:/network/http:lighttpd14
 194 .fi
 195 .in -2
 196 .sp
 197 .RE
 198
 199 .SH USER AUTHORIZATIONS
 200 .sp
 201 .LP
 202 You can use \fBRBAC(5)\fR to authorize otherwise non-privileged users to manage
 203 the \fBlighttpd14\fR service.
 204 To allow a user to manage the \fBlighttpd14\fR service states, add a line to
 205 \fB/etc/user_attr\fR of the form:
 206 .sp
 207 .in +2
 208 .nf
 209 <username>::::type=role;profiles=Lighttpd 14 Administration,All
 210 .fi
 211 .in -2
 212 .sp
 213 .LP
 214 Where <username> is the name of the user being granted the authorisation. If the user already has an entry in \fB/etc/user_attr\fR, add the "Lighttpd 14 Administration" profile to his or her entry.
 215 .sp
 216 .RE
 217
 218 .SH SPAWN-FCGI CHANGES
 219 .LP
 220 Version 1.4.23 of the Lighttpd web server sees the refactoring of the spawn-fcgi utility into a separate source distribution and as a result, spawn-fcgi has been spun out into a separate package named web/fastcgi/spawn-fcgi. The Lighttpd packages install web/fastcgi/spawn-fcgi as a dependency and provide symbolic links from the original locations of the spawn-fcgi executable and manpage to the locations delivered by the spawn-fcgi package, i.e.:
 221 .sp
 222 .in +2
 223 .nf
 224 /usr/lighttpd/1.4/bin/spawn-fcgi -> /usr/bin/spawn-fcgi
 225
 226 /usr/lighttpd/1.4/share/man/man1/spawn-fcgi.1
 227                     -> /usr/share/man/man1/spawn-fcgi.1
 228 .fi
 229 .in -2
 230 .sp
 231 .LP
 232 These symbolic links may be removed in a future update of the Lighttpd packages
 233 .sp
 234 .RE
 235
 236 .SH CONFIGURATION OPTIONS
 237 .sp
 238 .LP
 239 At this time, use of multiple Lighttpd worker processes is discouraged and is not supported by the Lighttpd community. From version 1.4.23 the supplied configuration file has the following line removed:
 240 .sp
 241 .in +2
 242 .nf
 243 server.max-worker = 4
 244 .fi
 245 .in -2
 246 .sp
 247 .LP
 248 The result of this change is that by default, Lighttpd will be run with a single worker process
 249 .sp
 250 .RE
 251
 252 .SH SEE ALSO
 253 .sp
 254 .LP
 255 \fBattributes(5)\fR, \fBlighttpd(8)\fR, \fBspawn-fcgi(8)\fR, \fBlighttpd-angel(8)\fR
 256 .sp
 257 .LP
 258 http://www.lighttpd.net
 259 .SH NOTES
 260 .sp
 261 .LP
 262 In addition to the documentation and man pages included with Solaris,
 263 more information is available at http://www.lighttpd.net\&.
 264 .sp
 265 .LP
 266 The Lighttpd man pages are provided with the programming modules. To
 267 view the manual pages for the Lighttpd modules with the man command, add \fB/usr/lighttpd/[version]/man\fR to the MANPATH environment variable.
 268 See \fBman(1)\fR for more information. Running \fBcatman(1M)\fR on
 269 the Lighttpd manual pages is not supported.