mktap(1)

mktap1

Create twisted.servers

Usage

mktap [options] apptype [application_option] ...

mktap apptype --help

Overview

The --help prints out a usage message to standard output.

--debug, -d

Show debug information for plugin loading.

--progress, -p

Show progress information for plugin loading.

--encrypted, -e

Encrypt file before writing (will make the extension of the resultant file begin with 'e').

--uid, -u <uid>

Application belongs to this uid, and should run with its permissions.

--gid, -d <gid>

Application belongs to this gid, and should run with its permissions.

--append, -a <file>

Append given servers to given file, instead of creating a new one. File should be be a tap file.

--appname, -n <name>

Use the specified name as the process name when the application is run with twistd(1). This option also causes some initialization code to be duplicated when twistd(1) is run.

--type, -t <type>

Specify the output file type. Available types are:

pickle - (default) Output as a python pickle file.
source - Output as a .tas (AOT Python source) file.

apptype Can be 'web', 'portforward', 'toc', 'coil', 'words', 'manhole', 'im', 'news', 'socks', 'telnet', 'parent', 'sibling', 'ftp', and 'mail'. Each of those support different options.

Options

-h, --host <host>

Proxy connections to <host>

-d, --dest_port <port>

Proxy connections to <port> on remote host.

-p, --port <port>

Listen locally on <port>

Options

-u, --user

Makes a server with ~/public_html and ~/.twistd-web-pb support for users.

--personal

Instead of generating a webserver, generate a ResourcePublisher which listens on ~/.twistd-web-pb

--path <path>

<path> is either a specific file or a directory to be set as the root of the web server. Use this if you have a directory full of HTML, cgi, php3, epy, or rpy files or any other files that you want to be served up raw.

-p, --port <port>

<port> is a number representing which port you want to start the server on.

-m, --mime_type <mimetype>

<mimetype> is the default MIME type to use for files in a --path web server when none can be determined for a particular extension. The default is 'text/html'.

--allow_ignore_ext

Specify whether or not a request for 'foo' should return 'foo.ext'. Default is off.

--ignore-ext .<extension>

Specify that a request for 'foo' should return 'foo.<extension>'.

-t, --telnet <port>

Run a telnet server on <port>, for additional configuration later.

-i, --index <name>

Use an index name other than "index.html"

--https <port>

Port to listen on for Secure HTTP.

-c, --certificate <filename>

SSL certificate to use for HTTPS. [default: server.pem]

-k, --privkey <filename>

SSL certificate to use for HTTPS. [default: server.pem]

--processor <ext>=<class name>

Adds a processor to those file names. (Only usable if after --path)

--resource-script <script name>

Sets the root as a resource script. This script will be re-evaluated on every request.

This creates a web.tap file that can be used by twistd. If you specify no arguments, it will be a demo webserver that has the Test class from twisted.web.test in it.

Options

-p <port>

<port> is a number representing which port you want to start the server on.

Options

-r, --relay <ip>,<port>=<queue directory>

Relay mail to all unknown domains through given IP and port, using queue directory as temporary place to place files.

-d, --domain <domain>=<path>

generate an SMTP/POP3 virtual maildir domain named "domain" which saves to "path"

-u, --username <name>=<password>

add a user/password to the last specified domains

-b, --bounce_to_postmaster

undelivered mails are sent to the postmaster, instead of being rejected.

-p, --pop <port>

<port> is a number representing which port you want to start the pop3 server on.

-s, --smtp <port>

<port> is a number representing which port you want to start the smtp server on.

This creates a mail.tap file that can be used by twistd(1)

Options

-p, --port <port>

Run the telnet server on <port>

-u, --username <name>

set the username to <name>

-w, --password <password>

set the password to <password>

Options

-i, --interface <interface>

Listen on interface <interface>

-p, --port <port>

Run the SOCKSv4 server on <port>

-l, --log <filename>

log connection data to <filename>

Options

-a, --anonymous

Allow anonymous logins

-3, --thirdparty

Allow third party connections

--otp

Use one time passwords (OTP)

-p, --port <port>

Run the FTP server on <port>

-r, --root <path>

Define the local root of the FTP server

--anonymoususer <username>

Define the the name of the anonymous user

Options

-p, --port <port>

Run the manhole server on <port>

-u, --user <name>

set the username to <name>

-w, --password <password>

set the password to <password>

Options

-p, --port <port>

Run the Words server on <port>

-i, --irc <port>

Run IRC server on port <port>

-w, --web <port>

Run web server on port <port>

Releases

5 releases since Debian 3.0 (Woody); the text changed 3 times.

  1. 3.0
  2. 3.1
  3. 4.0–5.0
  4. 6.0

--allow_ignore_ext since Debian 3.1 (Sarge); --appname since Debian 3.1 (Sarge); --certificate since Debian 3.1 (Sarge); --debug since Debian 4.0 (Etch); --encrypted since Debian 4.0 (Etch); --https since Debian 3.1 (Sarge); --ignore-ext since Debian 3.1 (Sarge); --interface since Debian 3.1 (Sarge); --mime_type since Debian 3.1 (Sarge); --path since Debian 3.1 (Sarge); --privkey since Debian 3.1 (Sarge); --progress since Debian 4.0 (Etch); --type since Debian 4.0 (Etch); -c since Debian 3.1 (Sarge); -e since Debian 4.0 (Etch); -k since Debian 3.1 (Sarge); -n since Debian 3.1 (Sarge).

--manholePass until Debian 3.0 (Woody); --manholePort until Debian 3.0 (Woody); --manholeUser until Debian 3.0 (Woody); --source until Debian 3.1 (Sarge); --static until Debian 3.0 (Woody); --xml until Debian 3.1 (Sarge); -x until Debian 3.1 (Sarge).

Author

Written by Moshe Zadka, based on mktap's help messages

Reporting bugs

To report a bug, visit http://twistedmatrix.com/bugs/

From python-twisted-core 10.1.0-3 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.