OnWorks favicon

htconfig - Online in the Cloud

Run htconfig in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command htconfig that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



htconfig - create/update GLOBAL gsearch.cgi files


htconfig -I [-v] [-z] [-a action] [-p pathdb] cgidir

htconfig --install [--verbose] [--makeghtml] [--formaction=cgi] [--pathdb=paths-file]

htconfig [-v] [-u url] [-d GTAGSDBPATH] [-s GTAGSROOT] [htmldir]

htconfig [--verbose] [--url=base-url] [--tags=GTAGSDBPATH] [--src=GTAGSROOT] [htmldir]


htconfig is a program to create and maintain a centralised cgi interface for hypertext
created with Shigio Yamaguchi's GLOBAL source code tag system.

htconfig is used to create the necessary scripts in your system's favoured cgi-bin
directory, and to maintain the paths database, which gsearch.cgi uses to locate your
hypertext source and the associated TAGS files. This enables GLOBAL's hypertext search
facilities without requiring you to enable cgi execution outside of a system-wide cgi-bin

htconfig acts as a backend for the htmake(1) script which automates the process of
generating hypertext source with the relevant options to htags(1) and adding required
entries to the paths database. htconfig can also optionally create a centralised
ghtml.cgi script, for users of the htags -c option which creates compressed hypertext with
a .ghtml suffix.


Common Options
-v, --verbose
uh, you get one guess.

Install Options
These options are to be used during the initial installation of the centralised cgi
mechanism. If you installed this as a binary package you probably won't need to use these
and can skip to the next section. Otherwise you must run htconfig --install with any or
all of the following options before using htmake(1) or any of the Database Options of

-I, --install
Creates gsearch.cgi in cgidir and creates the config file /etc/gtags/htmake.conf if
it doesn't already exist. You must specify cgidir, there is no default.

-a action, --formaction=action
Puts the default submit action for hypertext created with htmake(1) into
/etc/gtags/htmake.conf when that file is created. You can edit htmake.conf at any
time to change it, or override its setting from the command line. Setting this to
the absolute url of gsearch.cgi on your system is probably what you want here
unless you understand why not.
eg. --formaction=http://host/cgi-bin/gsearch.cgi

-p paths-database, --pathdb=paths-database
Puts the filesystem location of the paths database file into /etc/gtags/htmake.conf
when that file is created. You must define a location for the paths database
either with this option or by editing the GSPATHDATA option in htmake.conf before
using htmake(1) or the Database options of htconfig(1).
Due to file system variations there is no default for this. For Debian GNU/Linux
systems the preferred location is:
One suggestion for *BSD systems would be:

-z, --makeghtml
Installs the ghtml.cgi script in cgidir. You will also need edit your http server
config to make use of this. For apache this involves ensuring mod_mime and
mod_actions are loaded and adding lines like:
AddHandler htags-gzipped-html ghtml
Action htags-gzipped-html /cgi-bin/ghtml.cgi
to your httpd.conf file.

Database Options
These options are used to configure and maintain the path database that allows gsearch.cgi
to find your hypertext source and it's tag files. You should call htconfig with these
options when you move files or create a new hypertext source tree with htags(1). The path
database requires the hypertext source to be generated with a unique id using the htags
--id=someid option.

When creating a new hypertext source tree you may prefer to use htmake(1) which invokes
htags with the desired options and then calls htconfig to update the path database as a
single operation.

specifies the filesystem path to the root of your hypertext source tree. It
defaults to ./HTML in line with htags(1) defaults and is not required at all if the
--url option is used and your system has lynx(1) availiable,

-u base-url, --url=base-url
the base url of your hypertext source. For best results always use absolute url's
eg. http://host/~user/mysource
It defaults to file:/htmldir

-d gtagsdbpath, --tags=gtagsdbpath
the filesystem path to the GTAGS files associated with your source. It defaults to
the current directory.

-s gtagsroot, --src=gtagsroot
the filesystem path to the root of your original plaintext source tree. It
defaults to the current directory.


To initialise and install cgi and config files:

# htconfig -I -a http://host/cgi-bin/gsearch.cgi \
-p /var/lib/gsearch/pathdata /usr/lib/cgi-bin

To generate hypertext and update path database:

$ cd /usr/src/myprog
$ gtags
$ htags --action=http://host/cgi-bin/gsearch.cgi \
--id=uniqueid --nocgi
$ htconfig

or more simply:

$ cd /usr/src/myprog
$ gtags
$ htmake

To update the path database if you relocate your hypertext, TAGS files, or the original
program source:

$ htconfig -u new-url -d new-gtagsdbpath \
-s new-gtagsdbroot newhtmldir

some of these option may be inferred - See their defaults under Database Options

The user running htconfig or htmake must have write permission for the path database.

Use htconfig online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Modular headtracking program that
    supports multiple face-trackers, filters
    and game-protocols. Among the trackers
    are the SM FaceAPI, AIC Inertial Head
    Tracker ...
    Download facetracknoir
  • 2
    PHP QR Code
    PHP QR Code
    PHP QR Code is open source (LGPL)
    library for generating QR Code,
    2-dimensional barcode. Based on
    libqrencode C library, provides API for
    creating QR Code barc...
    Download PHP QR Code
  • 3
    Freeciv is a free turn-based
    multiplayer strategy game, in which each
    player becomes the leader of a
    civilization, fighting to obtain the
    ultimate goal: to bec...
    Download Freeciv
  • 4
    Cuckoo Sandbox
    Cuckoo Sandbox
    Cuckoo Sandbox uses components to
    monitor the behavior of malware in a
    Sandbox environment; isolated from the
    rest of the system. It offers automated
    analysis o...
    Download Cuckoo Sandbox
  • 5
    Play YouTube video on LMS (porting of
    Triode's to YouTbe API v3) This is
    an application that can also be fetched
    Download LMS-YouTube
  • 6
    Windows Presentation Foundation
    Windows Presentation Foundation
    Windows Presentation Foundation (WPF)
    is a UI framework for building Windows
    desktop applications. WPF supports a
    broad set of application development
    Download Windows Presentation Foundation
  • More »

Linux commands