{= include("docs.util"); start_docs_page(docs.technical_manual.page_titles.pathnames); =}
A pathname is a value which fully describes the location of a file or $lang_stats.directory on your computer. Pathnames are used in $PRODUCT_NAME to describe the locations of the log data, the server $lang_stats.directory, the {=docs_option_link('dd')=}, and other files and $lang_stats.directories.
The leftmost part of a pathname generally describes which hard drive or partition the file or $lang_stats.directory is on, and as you move from left to right along the pathname, each successive part narrows the location further by providing the name of an additional sub$(lang_stats.directory).
It is not generally necessary to type pathnames if you are using the $PRODUCT_NAME graphical web browser interface; the Browse button next to each pathname field provides a friendlier way to specify a pathname, using a familiar $lang_stats.directory browsing mechanism. This button is available everywhere except when choosing the server $lang_stats.directory in CGI mode, where you must enter the pathname manually.
Pathnames use different formats on different platforms. On Windows, the format is
driveletter:\$(lang_stats.directory)1\$(lang_stats.directory)2 ... $(lang_stats.directory)n\filename
for files, and the same for $lang_stats.directories, except that the final filename
is omitted (but not the final \
). For instance, a file my.conf
inside the $lang_stats.directory configs
, which is inside the $lang_stats.directory $PRODUCT_EXECUTABLE_DOCS
, which is inside the $lang_stats.directory web
on the C: drive, is represented by C:\web\$PRODUCT_EXECUTABLE_DOCS\configs\my.conf
. The $lang_stats.directory containing my.conf
is represented by C:\web\$PRODUCT_EXECUTABLE_DOCS\configs\
.
On MacOS X, Linux, or other UNIX-type systems, the format is
/$(lang_stats.directory)1/$(lang_stats.directory)2 ... $(lang_stats.directory)n/filename
for files, and the same for $lang_stats.directories, except that the final filename
is omitted (but not the final /
). For instance, a file my.conf
inside the $lang_stats.directory configs
, which is inside the $lang_stats.directory $PRODUCT_EXECUTABLE_DOCS
, which is inside the $lang_stats.directory web
(a sub$lang_stats.directory of the root /
$lang_stats.directory), is represented by /web/$PRODUCT_EXECUTABLE_DOCS/configs/my.conf
. The $lang_stats.directory containing my.conf
is represented by /web/$PRODUCT_EXECUTABLE_DOCS/configs/
.
{= end_docs_page() =}