source: trunk/base/doc/port-load.1.txt @ 124481

Last change on this file since 124481 was 124481, checked in by cal@…, 5 years ago

base: document port {load,unload,reload}

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 1.4 KB
Line 
1// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
2port-load(1)
3============
4$Id: port-load.1.txt 124481 2014-08-24 21:27:18Z cal@macports.org $
5
6NAME
7----
8port-load, port-unload, port-reload - Control daemons installed by a port
9
10SYNOPSIS
11--------
12[cmdsynopsis]
13*port* [*-d*] [*-D* 'portdir'] [*load* | *unload* | *reload*]
14     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
15
16DESCRIPTION
17-----------
18These commands control the daemons that are installed by some of the ports. If
19a port provides daemon functionality, a note will be printed during installation
20advising you how to use it.
21
22The daemon functionality is provided by installing a man:launchd[8]
23configuration file (see man:launchd.conf[5]) and calling man:launchctl[1] on
24your behalf. *port load* advises launchd to start the daemon defined by a port's
25configuration file, also called a ``startup item''. Once loaded, launchd will
26preserve this state - even across reboots - until the daemon is unloaded using
27*port unload*. If you want to restart a daemon, you can use *port reload*, which
28is a convenience wrapper around *port unload* followed by a short delay and
29*port load*.
30
31In theory, MacPorts supports generating startup items for older releases of OS
32X. In practice, these commands can not deal with pre-launchd interfaces and will
33fail on these systems.
34
35include::global-flags.txt[]
36
37SEE ALSO
38--------
39man:port[1], man:launchd[8], man:launchd.conf[5], man:launchctl[1]
40
41AUTHORS
42-------
43 (C) 2014 The MacPorts Project
44 Clemens Lang <cal@macports.org>
Note: See TracBrowser for help on using the repository browser.