NAME

pod_browser

VERSION

version 1.0.1

SYNOPSIS

  # start POD::Browser on port 3030
  pod_browser

  # Switch server implementation with --server (or -s)
  pod_browser --server HTTP::Server::Simple --port 9090 --host 127.0.0.1

  # Use UNIX socket to run FCGI daemon
  pod_browser -s FCGI --listen /tmp/fcgi.sock

  # FCGI external server on port 9090
  pod_browser -s FCGI --port 9090

OPTIONS

-o, --host

The interface a TCP based server daemon binds to. Defauts to undef, which lets most server backends bind the any (*) interface. This opeion doesn't mean anything if the server does not support TCP socket.

-p, --port

The port number a TCP based server daemon listens on. Defaults to 3030. This option doesn't mean anything if the server does not support TCP socket.

-s, --server

Select a specific implementation to run on using the PLACK_SERVER environment variable or use the -s or --server flag which will be preferred over the environment variable if present.

-S, --socket

UNIX domain socket path to listen on. Defaults to undef. This option doesn't mean anything if the server doesn't support UNIX sockets.

-l, --listen

Addresses to listen on. It could be "HOST:PORT", ":PORT" or "PATH" (without colons). It could be multiple but it depends on the server implementations whether multiple interfaces are supported.

-D, --daemonize

Makes the process go background. It's up to the backend server/handler implementation whether this option is respected or not.

-I

Specify perl library include path, like perl's -I option.

--access-log

Specify the pathname of a file where the access log should be written. In the development (i.e. --env devel) environment access logs will go to STDERR.

AUTHOR

Moritz Onken <onken@netcubed.de>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Moritz Onken.

This is free software, licensed under:

  The (three-clause) BSD License