A MacPorts Portfile is a Tcl script, so it may contain any arbitrary Tcl code you may learn about in a Tcl reference manual. However, few authors will use arbitrary Tcl code; the vast majority will use Tcl extensions that are coded within MacPorts for performing the most common tasks needed for Portfiles. The list below is a list of Tcl extensions provided by MacPorts base.
Description.
Description.
Shorthand alternative to file copy.
Shorthand alternative to file rename.
Deletes each of the given files/directories. Behaves similarly to file delete -force except that file delete -force will fail to delete directories properly on 10.3 systems.
Mimics the BSD touch command.
Mimics the BSD ln command.
xinstall copies files and creates directories; it is intended to be compatible with install(1).
owner] [-g
group] [-m
mode] [file1 file2
...] directoryInstall the specified file(s) to a destination directory.
owner] [-g
group] [-m
mode] [-W
dir] [file1 file2
...] directoryChange to dir and install file(s) to a
destination directory.
owner] [-g
group] [-m
mode] [glob
pattern]
directoryInstall the file(s) matching the glob pattern to a destination directory.
owner] [-g
group] [-m
mode]
directoryCreate a directory including parent directories if necessary.
Defaults:
owner -
group -
mode -
Examples:
xinstall -m 640 ${worksrcpath}/doc README \
${destroot}${prefix}/share/doc/${name}xinstall -m 640 -W ${worksrcpath}/doc README INSTALL COPY \
${destroot}${prefix}/share/doc/${name}eval xinstall -m 640 [glob ${worksrcpath}/doc/*] \
${destroot}${prefix}/share/doc/${name}xinstall -d ${destroot}${prefix}/share/doc/${name}strsed can be used for string manipulations using regular expressions. It supports a small subset of the commands known from sed(1).
string
s/regex/replacement/
Replaces the first instance of
regex with
replacement. Refer to
re_format(7) for a definition of regular expression
syntax.
string
g/regex/replacement/
The same as the previous format, except all instances of the pattern will be replaced, not only the first (mnemonic: 'g' is for global).
Allows text specified by a regular expression to be replaced by new text, in-place (the file will be updated itself, no need to place output into a new file and rename).
command
file ...Replace text given by the regular expression portion of the command with the replacement text, in all files specified.
Use -E to use the extended regular expression style (see re_format(7) for a description of the basic and extended styles)
Use -- to end option processing and allow any further dashes not to be treated as options.
Examples:
reinplace "s|/usr/local|${prefix}|g" ${worksrcpath}/configurereinplace "s|@@PREFIX@@|${prefix}|g" ${worksrcpath}/Makefileuid]
[gid=gid]
[passwd=passwd]
[realname=realname]
[home=home]
[shell=shell]Add a new local user to the system with the specified uid, gid, password, real name, home directory and login shell.
usernameCheck if a local user exists. Returns the uid for the given user, or 0 if the user wasn't found. Checking for the root user is not supported because its uid is 0, and it will always exist anyway.
Returns the highest used uid plus one.
group
[gid=gid]
[passwd=passwd]
[realname=realname]
[users=users]Add a new local group to the system, with the specified gid, password, real name, and with a list users as members.
groupCheck if a local group exists and return the corresponding gid. This can be used with adduser:
addgroup foo adduser foo gid=[existsgroup foo]
Returns the highest used gid plus one.
Use only when ....