t

CDDL HEADER START

The contents of this file are subject to the terms of the
Common Development and Distribution License (the "License").
You may not use this file except in compliance with the License.

You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions
and limitations under the License.

When distributing Covered Code, include this CDDL HEADER in each
file and include the License file at usr/src/OPENSOLARIS.LICENSE.
If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying
information: Portions Copyright [yyyy] [name of copyright owner]

CDDL HEADER END

Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.

lighttpd 1M "October 2009" "SunOS 5.11" "System Administration Commands"
NAME
lighttpd - a fast, secure and flexible webserver
SYNOPSIS

lighttpd
DESCRIPTION

The Lighttpd Web Server consists of a server daemon, a watchdog process, loadable server modules, configuration files and documentation.

FILES

The following paths specify the installation locations for Lighttpd:

Note :

The string [version] should be expanded to "MAJOR.MINOR". For example, /usr/lighttpd/1.4/*.

/etc/lighttpd/[version]

Contains lighttpd configuration files. A new install contains a single, default configuration file lighttpd.conf.

/etc/lighttpd/[version]/conf.d

Contains additional server configuration files. These files generally require some customisation and are therefore not automatically loaded by the main configuration file.

/usr/lighttpd/[version]/sbin

Contains the lighttpd executable and the lighttpd-angel watchdog process.

/usr/lighttpd/[version]/man

Contains man pages for the server and utility programs. Add this directory to your MANPATH to read the Lighttpd man pages. See Notes.

/usr/lighttpd/[version]/lib

Contains the Lighttpd loadable modules. These can be loaded by using directives in the configuration file.

/var/lighttpd/[version]/docroot

The default location for content as specified by the server.document-root directive in the Lightpd configuration file.

/var/lighttpd/[version]/logs

This is the default location for the Lighttpd log files. The formats, names, and locations of the files in this directory can be altered by various configuration directives in the lighttpd.conf file.

SERVICE MANAGEMENT FACILITY

The lighttpd14 package for Solaris (web/server/lighttpd-14) includes all of the files necessary to register Lighttpd with the Service Management Facility described in SMF(5). The following procedure describes the steps to automate service management for lighttpd. Note :

The the full name of the lighttpd service is svc:/network/http:lighttpd14 This can be abbreviated to lighttpd14 which is the instance name of the service.

1. To enable the lighttpd14 service. 

example% svcadm enable lighttpd14
The state of the service instance changes to online, and the lighttpd14 service instance is now available: 
example% svcs lighttpd14
STATE STIME FMRI
online 11:22:17 svc:/network/http:lighttpd14

2. To disable the lighttpd14 service instance, 

example% svcadm disable lighttpd14
The state of the service instance changes to disabled, and the lighttpd service instance is no longer available: 
example% svcs lighttpd14
STATE STIME FMRI
disabled 11:35:15 svc:/network/http:lighttpd14
USER AUTHORIZATIONS

You can use RBAC(5) to authorize otherwise non-privileged users to manage the lighttpd14 service. To allow a user to manage the lighttpd14 service states, add a line to /etc/user_attr of the form: 

<username>::::type=role;profiles=Lighttpd 14 Administration,All

Where <username> is the name of the user being granted the authorisation. If the user already has an entry in /etc/user_attr, add the "Lighttpd 14 Administration" profile to his or her entry.

SPAWN-FCGI CHANGES

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.: 

/usr/lighttpd/1.4/bin/spawn-fcgi -> /usr/bin/spawn-fcgi

/usr/lighttpd/1.4/share/man/man1/spawn-fcgi.1
 -> /usr/share/man/man1/spawn-fcgi.1

These symbolic links may be removed in a future update of the Lighttpd packages

CONFIGURATION OPTIONS

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: 

server.max-worker = 4

The result of this change is that by default, Lighttpd will be run with a single worker process

SEE ALSO

attributes(5), lighttpd(8), spawn-fcgi(8), lighttpd-angel(8)

http://www.lighttpd.net

NOTES

In addition to the documentation and man pages included with Solaris, more information is available at http://www.lighttpd.net.

The Lighttpd man pages are provided with the programming modules. To view the manual pages for the Lighttpd modules with the man command, add /usr/lighttpd/[version]/man to the MANPATH environment variable. See man(1) for more information. Running catman(1M) on the Lighttpd manual pages is not supported.