package cgi

Import Path
	net/http/cgi (on go.dev)

Dependency Relation
	imports 21 packages, and imported by one package

Involved Source Files

	    cgi_main.go
	    child.go
	  d host.go
		Package cgi implements CGI (Common Gateway Interface) as specified
		in RFC 3875.
		
		Note that using CGI means starting a new process to handle each
		request, which is typically less efficient than using a
		long-running server. This package is intended primarily for
		compatibility with existing systems.
Package-Level Type Names (only one)

	/* sort by: alphabet | popularity */
	 type Handler (struct)
		Handler runs an executable in a subprocess with a CGI environment.

		Fields (total 9)
			Args []string
				// optional arguments to pass to child process

			Dir string
				Dir specifies the CGI executable's working directory.
				If Dir is empty, the base directory of Path is used.
				If Path has no base directory, the current working
				directory is used.

			Env []string
				// extra environment variables to set, if any, as "key=value"

			InheritEnv []string
				// environment variables to inherit from host, as "key"

			Logger *log.Logger
				// optional log for errors or nil to use log.Print

			Path string
				// path to the CGI executable

			PathLocationHandler http.Handler
				PathLocationHandler specifies the root http Handler that
				should handle internal redirects when the CGI process
				returns a Location header value starting with a "/", as
				specified in RFC 3875 § 6.3.2. This will likely be
				http.DefaultServeMux.
				
				If nil, a CGI response with a local URI path is instead sent
				back to the client and not redirected internally.

			Root string
				// root URI prefix of handler or empty for "/"

			Stderr io.Writer
				// optional stderr for the child process; nil means os.Stderr

		Methods (only one)
			(*Handler) ServeHTTP(rw http.ResponseWriter, req *http.Request)
		Implements (at least one exported)
			*Handler : net/http.Handler


Package-Level Functions (total 3)

	 func Request() (*http.Request, error)
		Request returns the HTTP request as represented in the current
		environment. This assumes the current program is being run
		by a web server in a CGI environment.
		The returned Request's Body is populated, if applicable.

	 func RequestFromMap(params map[string]string) (*http.Request, error)
		RequestFromMap creates an [http.Request] from CGI variables.
		The returned Request's Body field is not populated.

	 func Serve(handler http.Handler) error
		Serve executes the provided [Handler] on the currently active CGI
		request, if any. If there's no current CGI environment
		an error is returned. The provided handler may be nil to use
		[http.DefaultServeMux].

The pages are generated with Golds v0.7.0-preview. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.