Propellor.Property.Apt

Documentation

data HostMirror

Constructors

HostMirror Url

Instances

Eq HostMirror

Defined in Propellor.Property.Apt

Methods

(==) :: HostMirror -> HostMirror -> Bool

(/=) :: HostMirror -> HostMirror -> Bool

Show HostMirror

Defined in Propellor.Property.Apt

Methods

showsPrec :: Int -> HostMirror -> ShowS

show :: HostMirror -> String

showList :: [HostMirror] -> ShowS

data HostAptProxy

Constructors

HostAptProxy Url

Instances

Eq HostAptProxy

Defined in Propellor.Property.Apt

Methods

(==) :: HostAptProxy -> HostAptProxy -> Bool

(/=) :: HostAptProxy -> HostAptProxy -> Bool

Show HostAptProxy

Defined in Propellor.Property.Apt

Methods

showsPrec :: Int -> HostAptProxy -> ShowS

show :: HostAptProxy -> String

showList :: [HostAptProxy] -> ShowS

mirror :: Url -> Property (HasInfo + UnixLike)

Indicate host's preferred apt mirror

getMirror :: Propellor Url

withMirror :: Desc -> (Url -> Property DebianLike) -> Property DebianLike

sourcesList :: FilePath

type Url = String

type Section = String

type SourcesGenerator = DebianSuite -> [Line]

showSuite :: DebianSuite -> String

backportSuite :: DebianSuite -> Maybe String

stableUpdatesSuite :: DebianSuite -> Maybe String

debLine :: String -> Url -> [Section] -> Line

srcLine :: Line -> Line

stdSections :: [Section]

binandsrc :: String -> SourcesGenerator

stdArchiveLines :: Propellor SourcesGenerator

securityUpdates :: SourcesGenerator

Only available for Stable suites, not for Testing or Unstable.

stdSourcesList :: Property Debian

Makes sources.list have a standard content using the Debian mirror CDN (or other host specified using the mirror property), with the Debian suite configured by the os.

stdSourcesListFor :: DebianSuite -> Property Debian

stdSourcesList' :: DebianSuite -> [SourcesGenerator] -> Property Debian

Adds additional sources.list generators.

Note that if a Property needs to enable an apt source, it's better to do so via a separate file in /etc/apt/sources.list.d/

type PinPriority = Int

suiteAvailablePinned :: DebianSuite -> PinPriority -> RevertableProperty Debian Debian

Adds an apt source for a suite, and pins that suite to a given pin value (see apt_preferences(5)). Revert to drop the source and unpin the suite.

If the requested suite is the host's OS suite, the suite is pinned, but no source is added. That apt source should already be available, or you can use a property like stdSourcesList.

setSourcesList :: [Line] -> Property DebianLike

setSourcesListD :: [Line] -> FilePath -> Property DebianLike

runApt :: [String] -> UncheckedProperty DebianLike

noninteractiveEnv :: [(String, String)]

update :: Property DebianLike

Have apt update its lists of packages, but without upgrading anything.

upgrade :: Property DebianLike

Have apt upgrade packages, adding new packages and removing old as necessary. Often used in combination with the update property.

upgrade' :: String -> Property DebianLike

safeUpgrade :: Property DebianLike

Have apt upgrade packages, but never add new packages or remove old packages. Not suitable for upgrading acrocess major versions of the distribution.

pendingConfigured :: Property DebianLike

Have dpkg try to configure any packages that are not fully configured.

type Package = String

installed :: [Package] -> Property DebianLike

installedMin :: [Package] -> Property DebianLike

Minimal install of package, without recommends.

installed' :: [String] -> [Package] -> Property DebianLike

backportInstalled :: [Package] -> Property Debian

Install packages from the stable-backports suite.

If installing the backport requires installing versions of a package's dependencies from stable-backports too, you will need to include those dependencies in the list of packages passed to this function.

backportInstalledMin :: [Package] -> Property Debian

Minimal install from the stable-backports suite, without recommends.

backportInstalled' :: [String] -> [Package] -> Property Debian

removed :: [Package] -> Property DebianLike

buildDep :: [Package] -> Property DebianLike

buildDepIn :: FilePath -> Property DebianLike

Installs the build deps for the source package unpacked in the specifed directory, with a dummy package also installed so that autoRemove won't remove them.

type AptPackagePref = String

The name of a package, a glob to match the names of packages, or a regexp surrounded by slashes to match the names of packages. See apt_preferences(5), "Regular expressions and glob(7) syntax"

pinnedTo :: [AptPackagePref] -> [(DebianSuite, PinPriority)] -> RevertableProperty Debian Debian

Pins a list of packages, package wildcards and/or regular expressions to a list of suites and corresponding pin priorities (see apt_preferences(5)). Revert to unpin.

Each package, package wildcard or regular expression will be pinned to all of the specified suites.

Note that this will have no effect unless there is an apt source for each of the suites. One way to add an apt source is suiteAvailablePinned.

For example, to obtain Emacs Lisp addon packages not present in your release of Debian from testing, falling back to sid if they're not available in testing, you could use

& Apt.suiteAvailablePinned Testing (-10)
& Apt.suiteAvailablePinned Unstable (-10)
& ["elpa-*"] `Apt.pinnedTo` [(Testing, 100), (Unstable, 50)]

pinnedTo' :: AptPackagePref -> [(DebianSuite, PinPriority)] -> RevertableProperty Debian Debian

robustly :: Property DebianLike -> Property DebianLike

Package installation may fail becuse the archive has changed. Run an update in that case and retry.

isInstalled :: Package -> IO Bool

isInstalled' :: [Package] -> IO Bool

data InstallStatus

Constructors

IsInstalled

NotInstalled

Instances

Eq InstallStatus

Defined in Propellor.Property.Apt

Methods

(==) :: InstallStatus -> InstallStatus -> Bool

(/=) :: InstallStatus -> InstallStatus -> Bool

Show InstallStatus

Defined in Propellor.Property.Apt

Methods

showsPrec :: Int -> InstallStatus -> ShowS

show :: InstallStatus -> String

showList :: [InstallStatus] -> ShowS

getInstallStatus :: [Package] -> IO [InstallStatus]

autoRemove :: Property DebianLike

unattendedUpgrades :: RevertableProperty DebianLike DebianLike

Enables unattended upgrades. Revert to disable.

periodicUpdates :: Property DebianLike

Enable periodic updates (but not upgrades), including download of packages.

type DebconfTemplate = String

type DebconfTemplateType = String

type DebconfTemplateValue = String

reConfigure :: Package -> [(DebconfTemplate, DebconfTemplateType, DebconfTemplateValue)] -> Property DebianLike

Preseeds debconf values and reconfigures the package so it takes effect.

serviceInstalledRunning :: Package -> Property DebianLike

Ensures that a service is installed and running.

Assumes that there is a 1:1 mapping between service names and apt package names.

data AptKey

Constructors

AptKey

Fields

• keyname :: String
• pubkey :: String

trustsKey :: AptKey -> RevertableProperty DebianLike DebianLike

trustsKey' :: AptKey -> Property DebianLike

untrustKey :: AptKey -> Property DebianLike

aptKeyFile :: AptKey -> FilePath

cacheCleaned :: Property DebianLike

Cleans apt's cache of downloaded packages to avoid using up disk space.

hasForeignArch :: String -> Property DebianLike

Add a foreign architecture to dpkg and apt.

noPDiffs :: Property DebianLike

Disable the use of PDiffs for machines with high-bandwidth connections.

suitePin :: DebianSuite -> String

suitePinBlock :: AptPackagePref -> DebianSuite -> PinPriority -> [Line]

dpkgStatus :: FilePath

proxy :: Url -> Property (HasInfo + DebianLike)

Set apt's proxy

proxy' :: Url -> Property DebianLike

useLocalCacher :: Property (HasInfo + DebianLike)

Cause apt to proxy downloads via an apt cacher on localhost