PLN(5)

NAME
pln - progressive label notation

DESCRIPTION
Progressive Label Notation is a configuration format used by rset(1), and is designed to be evaluated sequentially. pln supports options defined by key=value pairs and text fragments designated by tab indentation

    interpreter=/bin/sh -x
    packages:
    	pkg_add ruby%3.2
    	ln -sf /usr/local/bin/ruby32 /usr/local/bin/ruby
    	ln -sf /usr/local/bin/irb32 /usr/local/bin/irb
    services:
    	./rinstall mail/smtpd_relay.conf /etc/mail/smtpd.conf \
    	    && rcctl restart smtpd
    # vim:ts=4:syntax=sh

A label may also be followed by special content between a pair of braces on the beginning of a line. A common use for this is to set environment variables using local configuration

    www:
    {
    	cat ssl.env
    }
    	echo $SSL_PASSWORD > /etc/keys/global.pass

OPTIONS
Each option may be set multiple times, and is effective for labels that follow. Reset an option to the implementation-defined default using ‘=’ without a value.

LABELS
Label names do not need to be unique and may contain any series of characters except for single and double quotes. A series of pathnames for use by the application may be specified after the ‘’:

    svc1.local: etc/ rc.d/
    	httpd.pln

Labels may be split into multiple aliases separated by using commas

    svc1.local,10.0.0.10:
    	common.pln

Alternatively, sequence expressions may be used to match a range of hosts

    db{1..4}.local:
    	autofailover.pln

COMMENTS
Comments begin with a hash (‘#’) character, and can only be used the beginning of a line.

SEE ALSO
labelgrep(1)