pmk.conf(5) premake configuration file

DESCRIPTION

pmk.conf contains a series of assignements that are used by pmk(1) and created by pmksetup(8).

DATA TYPES

These are common types used by pmk, see pmkfile(5) for a complete description.

OPERATORS

=
This operator makes the value dynamic, which means that it will be (re)assigned everytime you run pmksetup(8).

For example:

BIN_CC = "/usr/bin/cc"
:
This operator makes the value static, which means that if you want to regenerate the pmk.conf the value will be kept and not dynamically assigned by pmksetup(8).

For example:

BIN_INSTALL:"/usr/local/bin/install"

FAMILY CLASSES

Assignements can be classed in different families.

AC_*
Compatibility with autoconf.
BIN_*
This class is used for binary paths.
HW_*
Hardware related data like for example byte order or cpu features.
PATH_*
Specific paths family.
OS_*
System specific data.
misc
Some other data (such as PREFIX) cannot fit into previous families.

AC CLASS

This class is providing some variables for GNU Autoconf compatibility:

AC_ECHO_C
Support for "\c".
AC_ECHO_N
Support for "\n".
AC_ECHO_T
Support for "\t".

BIN CLASS

This class is providing locations of various useful binaries such as ar, as, cc, cpp, ...

HW CLASS

This class is giving some information about the host hardware.

HW_BYTEORDER
Provide the byte order of the host: 'BIG_ENDIAN' or 'LITTLE_ENDIAN'.
HW_CPU_ARCH
Identify the cpu architecture.

We support actually the following architectures (with cpu identification for some of them):

alpha

HW_ALPHA_CPU_CLASS
Cpu class (EV4, EV5 or EV6).
HW_ALPHA_CPU_FEATURES
Cpu features list (BWX, FIX, CIX, MVI, PAT and PMI)

ia_64

HW_IA64_CPU_ARCHREV
Cpu architecture revision number.
HW_IA64_CPU_CLASS
Cpu class ('Itanium' or 'Itanium2')
HW_IA64_CPU_FAMILY
Cpu family number.
HW_IA64_CPU_FEATURES
Cpu features list (LB, SD and AO).
HW_IA64_CPU_MODEL
Cpu model number.
HW_IA64_CPU_REVISION
Cpu revision number.
HW_IA64_CPU_VENDOR
Cpu vendor string.

m68k
No specific variables.
parisc_64
No specific variables.
ppc
No specific variables.
sparc_32
No specific variables.
sparc_64
No specific variables.
x86_32

HW_X86_CPU_CLASS
Cpu family class (386, 486, 586, ...).
HW_X86_CPU_EXTFAM
Extended family number.
HW_X86_CPU_EXTMOD
Extended model number.
HW_X86_CPU_FAMILY
Cpu family number.
HW_X86_CPU_FEATURES
Cpu features list (FPU, VME, DE, PSE, TSC, ...).
HW_X86_CPU_MODEL
Cpu model number.
HW_X86_CPU_STD_VENDOR
Standardised cpu vendor ('INTEL', 'AMD', ...).
HW_X86_CPU_VENDOR
Cpu vendor string.

x86_64
Same as x86_32 architecture.
vax
No specific variables.

OS CLASS

This class is providing informations about the host's operating system:

OS_ARCH
Operating system architecture (warning: this is OS specific).
OS_NAME
Operating system name (warning: linux distributions return the kernel name).
OS_VERSION
Operating system version (warning: linux distributions return the kernel version).

PATH CLASS

This class is providing path for binaries, headers and libraries.

MISC CLASS

This class is regrouping what can not be classed elsewhere.

PREFIX
Prefix environnement variable.
SYSCONFDIR
System configuration directory.
PC_PATH_LIB
Library path for pmkpc or pkg_config.

FILES

/etc/pmk/pmk.conf
default pmk(1) configuration file

EXAMPLES

A typical pmk.conf might appear as follows:
# autoconf compatibility
AC_ECHO_C = "\c"
AC_ECHO_N = ""
AC_ECHO_T = ""
# specific binaries
BIN_AR = "/usr/bin/ar"
BIN_AS = "/usr/bin/as"
BIN_AWK = "/usr/bin/awk"
BIN_CAT = "/bin/cat"
BIN_CC = "/usr/bin/cc"
BIN_CPP = "/usr/bin/cpp"
BIN_CXX = "/usr/bin/c++"
BIN_ECHO = "/bin/echo"
BIN_EGREP = "/usr/bin/egrep"
BIN_GREP = "/usr/bin/grep"
BIN_ID = "/usr/bin/id"
BIN_INSTALL = "/usr/bin/install"
BIN_LEX = "/usr/bin/lex"
BIN_LN = "/bin/ln"
BIN_PKGCONFIG = "/usr/local/bin/pkg-config"
BIN_RANLIB = "/usr/bin/ranlib"
BIN_SH = "/bin/sh"
BIN_STRIP = "/usr/bin/strip"
BIN_SUDO = "/usr/bin/sudo"
BIN_TAR = "/bin/tar"
BIN_YACC = "/usr/bin/yacc"
# architecture specific
HW_BYTEORDER = "LITTLE_ENDIAN"
HW_CPU_ARCH = "x86_32"
HW_X86_CPU_CLASS = "i686"
HW_X86_CPU_EXTFAM = "0"
HW_X86_CPU_EXTMOD = "0"
HW_X86_CPU_FAMILY = "15"
HW_X86_CPU_FEATURES = "FPU VME DE PSE TSC MSR PAE MCE CX8 APIC SEP MTRR PGE MCA CMOV PAT PSE36 CLFL DTES ACPI MMX FXR SSE SSE2 HTT TM1 PBE FPU MON DSCPL EST TM2 CX16 ETPRD "
HW_X86_CPU_MODEL = "2"
HW_X86_CPU_STD_VENDOR = "INTEL"
HW_X86_CPU_VENDOR = "GenuineIntel"
# OS related
OS_ARCH = "i386"
OS_NAME = "OpenBSD"
OS_VERSION = "3.6"
# PATH related
PATH_BIN = "/bin,/sbin,/usr/bin,/usr/sbin,/usr/X11R6/bin,/usr/local/sbin,/usr/local/bin"
PATH_INC = "/usr/include"
PATH_LIB = "/usr/lib"
# misc
PC_PATH_LIB = "$PREFIX/lib/pkgconfig"
PREFIX = "/usr/local"
SYSCONFDIR = "/etc"