poudriere

The ucl module provides a Lua interface to the libucl C library, allowing you to parse UCL/JSON/YAML strings and files into Lua tables, and convert Lua tables back into formatted strings (like JSON or UCL).

local ucl = require("ucl")

local parser = ucl.parser()
local res, err = parser:parse_string('{key=value}')

if not res then
	print('parser error: ' .. err)
else
	local obj = parser:get_object()
	local got = ucl.to_format(obj, 'json')
end

cpdup is a filesystem mirroring utility that creates an exact mirror of a source in a destination.

Key behaviors:

• Synchronization: It creates and deletes files and directories as necessary to ensure the destination matches the source.
• Metadata Preservation: It mirrors UTimes, hardlinks, softlinks, devices, permissions, and flags.
• Efficiency: By default, it does not copy files that appear already synchronized (where source and destination sizes and mtimes match).
• Safety Measures:
  • It asks for confirmation before removing any file or directory from the destination.
  • It refuses to replace a destination directory with a file.
• Limitations: It does not cross mount points in either the source or the destination.

Enabling PKG_NO_VERSION_FOR_DEPS=yes introduces several changes to how Poudriere operates:

• Dry-run limitations: Dry-run mode can no longer predict exactly what will be done because shared library satisfaction is determined by inspecting packages after they are built.
• Inspection Category: A new "inspected" category is used. Poudriere inspects a port to see if its shared library dependencies are satisfied. If they are, the port is considered done; if not, it is rebuilt.
• Importance of PORTREVISION: In the default mode, recursive deletion often hid the importance of PORTREVISION bumps. In this new mode, PORTREVISION bumps become critical because rebuilds only occur if the version or a required shared library version actually changes.

UCL supports validation using the JSON Schema v4 standard. You can define your schema in either JSON or UCL format.

Because UCL supports multiple values for keys (implicit arrays), you can use generic integer constraints like maxValues and minValues to define the limits of how many values a single key can contain.

To install poudriere from source and perform the initial configuration, follow these steps:

1. Build and install the tool from the top-level directory using ./configure, make, and make install.
2. Initialize the configuration file by copying the sample configuration to the active location: /usr/local/etc/poudriere.conf.sample to /usr/local/etc/poudriere.conf.
3. Edit /usr/local/etc/poudriere.conf to match your environment and requirements.
4. For specific usage patterns, consult the EXAMPLES section in the man poudriere manual page or follow the "bulk build of binary packages" guide in the official wiki.

./configure
make
make install
cp /usr/local/etc/poudriere.conf.sample /usr/local/etc/poudriere.conf

Poudriere offers two incremental build modes. By default, Poudriere rebuilds everything downstream if a dependency changes, which often results in rebuilding packages that pkg upgrade would not actually install.

To align Poudriere's behavior with pkg upgrade (only rebuilding what would actually be upgraded), enable the new incremental mode by setting the environment variable PKG_NO_VERSION_FOR_DEPS=yes.

In this mode, Poudriere does not store specific versions for dependencies. For example, if foo-1.2 is bumped to foo-1.3, it will no longer force a rebuild of downstream packages because the dependency is registered as foo rather than a specific version.

export PKG_NO_VERSION_FOR_DEPS=yes
# Then run your poudriere commands

If you need to distribute cpdup as a package rather than installing it directly from source, use the provided Makefile targets:

Arch Linux

Generate a package using make archpkg and then install it using pacman -U.

CentOS

Generate an RPM using make rpm and then install it using rpm -ivh.

Note: Use wildcards to match the generated filename.

# Arch Linux
make archpkg
sudo pacman -U cpdup-*.pkg.*

# CentOS
make rpm
sudo rpm -ivh cpdup-*.rpm