11 Executing your WebKit program

Contents of this section

To execute a WebKit program by Direct mode, you reference it like any other CGI program, something like http://your.host.here/cgi-bin/webkit/programname.

A WebKit Gateway mode program is invoked with a more complex syntax, which points to the webkit-gateway stub program and uses additional path information after the name of the WebKit program itself. You specify the location of the stub program, followed by the name or IP address of the host where the Gateway program is running, followed by a colon and a port number. That port number can be a numeric literal or a name from /etc/services that is visible to the Gateway host. For example, <A HREF=/cgi-bin/webkit-gateway/www.wgs.com:5050>Cheese!</A> triggers a connection to port 5050 on www.wgs.com.

You'll note that the Gateway mode examples use port names instead of numbers, like 'example1' and so on. This won't work unless you add matching lines to your /etc/services, like these. The number is totally arbitrary, but it must be at least 1024 unless you run httpd as root (not recommended).

----------/etc/services, cut here------------
# For WebKit examples only!
example1        1234/tcp
example2        1235/tcp
----------/etc/services, cut here------------

Next Chapter, Previous Chapter

Table of contents of this chapter, General table of contents

Top of the document, Beginning of this Chapter