🪴 Zero's Garden

Anatomy

3 min read

Database

/* ports table */
"CREATE TABLE registry.ports ("
        "id INTEGER PRIMARY KEY" // row ID
    ", name TEXT COLLATE NOCASE" // name of the port
    ", portfile TEXT" // path of Portfile copy
    ", location TEXT" // image (binary archive) location
    ", epoch INTEGER" // part of version comparison
    ", version TEXT COLLATE VERSION" // part of version comparison
    ", revision INTEGER" // part of version comparison
    ", variants TEXT" // actual variants used to build port
    ", requested_variants TEXT" // variants explicitly requested by user
    ", state TEXT" // installed (activated) or imaged (has image)
    ", date DATETIME" // install date
    ", installtype TEXT" // unused, always "image"
    ", archs TEXT" // list of architectures of this port
    ", requested INTEGER" // is port requested (boolean)
    ", os_platform TEXT" // operating system (e.g. darwin)
    ", os_major INTEGER" // OS version
    ", cxx_stdlib TEXT" // stdlib used for C++ ("libstdc++" or "libc++")
    ", cxx_stdlib_overridden INTEGER" // flag to track broken C++ ports
    ", UNIQUE (name, epoch, version, revision, variants)"
    ")",
"CREATE INDEX registry.port_name ON ports"
    "(name, epoch, version, revision, variants)",
"CREATE INDEX registry.port_state ON ports(state)",
 
/* file map */
"CREATE TABLE registry.files ("
        "id INTEGER" // row ID
    ", path TEXT" // file path
    ", actual_path TEXT" // actual path installed (FS case-sensitivity)
    ", active INTEGER" // is file installed
    ", binary BOOL" // is file a binary (rev-upgrade check)
    ", FOREIGN KEY(id) REFERENCES ports(id))",
"CREATE INDEX registry.file_port ON files(id)",
"CREATE INDEX registry.file_path ON files(path)",
"CREATE INDEX registry.file_actual ON files(actual_path)",
"CREATE INDEX registry.file_actual_nocase ON files(actual_path COLLATE NOCASE)",
 
/* dependency map */
"CREATE TABLE registry.dependencies ("
        "id INTEGER" // row ID
    ", name TEXT" // name of the port
    ", variants TEXT" // variants of the port
    ", FOREIGN KEY(id) REFERENCES ports(id))", // the dependency
"CREATE INDEX registry.dep_id ON dependencies(id)",
"CREATE INDEX registry.dep_name ON dependencies(name)",

Versioning

epoch > version > revision

Prefixes

MacPorts defaults to /opt/local, but allows alternatives prefixes.

Phases

  • fetch

Fetch the ${distfiles} (e.g. source code).

  • checksum

Compare ${checksums} specified in a Portfile to the checksums of the fetched ${distfiles}.

  • extract

Extract the ${distfiles} into working directory for build.

  • patch

Apply optional patch files.

  • configure

Execute ${configure.cmd} in ${worksrcpath}.

  • build

Execute ${build.cmd} in ${worksrcpath}.

  • destroot

Execute command to “stages” an installation into an intermediate location ${destroot}.

  • install

Archive (a.k.a. Image) a port’s destrooted files into ${prefix}/var/macports/software.

  • activate

Extract the port’s files from the archive in ${prefix}/var/macports/software to their final installed locations, usually in ${prefix}.

PortGroup

Rolling release (synced with ports tree) of utility functions to help make Portfiles more concice and declarative.

Variants

Maximum flexibility, but brings a lot of headache. Prefer non-conflicting subports if possible.

Subports

A directive used in Portfile to generate multiple port definitions from a single Portfile.

C++ stdlib

The default C++ runtime on OS X 10.9 and later is libc++ from LLVM which supports C++11.

For older OS X versions, MacPorts will install a functional libc++ toolchain by default to replace the ancient version of libstdc++ OS X shipped.

On Linux libstdc++ (The GNU C++ Library) is more ubiquitous.

Graph View