docs/reference/commands/mask.btft

[table class="topnav"]
[tr]
[td class="logotab"]mp[e]
[td][see name="index"]index[e][e]
[td][see name="guide/index"]guide[e][e]
[td][see name="reference/index"]reference[e][e]
[e]
[e]
 
[h1]mp mask[e]
 
[h2]synopsis[e]
 
[code]
mp mask <pkg>
[e]
 
[h2]description[e]
 
hides the given package from auto-pick (a %tag dependency resolving among providers will skip it) and blocks it from being explicitly installed too -- persisted as [code]MASK=yes[e] in [code]WD/pkgconf.conf[e]. different axis from [see name="reference/commands/hold"]hold[e]: mask is about "never choose this, ever", hold is about "don't touch whatever's currently installed".
 
[code]--unmask[e] on a single [code]mp install[e]/etc. invocation overrides a mask for just that one call, without lifting it persistently -- for that, use [see name="reference/commands/unmask"]mp unmask[e] instead.
 
[h2]examples[e]
 
[code]
mp mask brokenpkg
ok: brokenpkg masked (persisted in /usr/mp/pkgconf.conf -- 'mp install --unmask' still overrides for a single invocation; use 'mp unmask' to lift this persistently).
mp install --unmask brokenpkg   # one-off override, mask stays in effect afterward
mp unmask brokenpkg             # lifts it persistently
[e]
 
[h2]see also[e]
 
[see name="reference/commands/unmask"]unmask[e], [see name="reference/commands/hold"]hold[e], [see name="reference/commands/providers"]providers[e].