'\" t
.\"     Title: locks
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-05-05
.\"    Manual: LIBZYPP
.\"    Source: SUSE Linux
.\"  Language: English
.\"
.TH "LOCKS" "5" "2024-05-05" "SUSE Linux" "LIBZYPP"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
locks \- libzypp locking file
.SH "DESCRIPTION"
.sp
The file \fI/etc/zypp/locks\fP is read by libzypp at start\-up if \fIzypp.conf\fP allows it. The entries are used for initial locking of packages. Locking a package means not allowing to install or uninstall it.
.sp
Valid entries are of the form:
.sp
\fIattribute\fP\fB:\fP \fIvalue\fP
.RS 4
Where attributes and their values are described below.
.RE
.sp
Locks are separated by an empty lines.
.SH "ATTRIBUTES"
.sp
All attributes are lower\-case.
.sp
\fBrepo\fP
.RS 4
specifies repository restriction. Only alias is accepted.
.br
By default all repositories match.
.RE
.sp
\fBtype\fP
.RS 4
resolvable type restriction. The values can be \fBpackage\fP, \fBpatch\fP, \fBpattern\fP, \fBproduct\fP and \fBsrcpackage\fP.
.br
By default all types match.
.RE
.sp
\fBcase_sensitive\fP
.RS 4
if strings are matched case sensitive. The values are \fBtrue\fP, \fBfalse\fP, \fBon\fP, \fBoff\fP.
.br
The default is case insensitive.
.RE
.sp
\fBinstall_status\fP
.RS 4
status of object. Possible states are \fBinstalled\fP, \fBnot\-installed\fP and \fBall\fP. If more install statuses are specified then the last one is used. The values are \fBinstalled\fP for all packages which are installed, \fBnon\-installed\fP for packages which can be installed or reinstalled and \fBall\fP for both.
.br
The default is \fBall\fP.
.RE
.sp
\fBmatch_type\fP
.RS 4
type of string matching in values. Does not affect \fBtype\fP and \fBrepo\fP which must be specified exactly. The values are \fBexact\fP, \fBsubstring\fP, \fBregex\fP for regular expressions, \fBglob\fP for matching as on the command line, and \fBword\fP.
.br
The default is \fBsubstring\fP.
.RE
.sp
\fBquery_string\fP
.RS 4
String to be matched in multiple attributes. Should be restricted by another attribute with empty value (it is recommended, because without restriction expect some performance problems).
.RE
.sp
\fBversion\fP
.RS 4
Restrict the lock only to some versions. It contains two parts: an optional operator and the version.
.br
The operator is \fB==\fP, \fB!=\fP, \fB<\fP, \fB>\fP, \fB\(lA\fP, \fB>=\fP.  If operator is not specified then \fB==\fP is used.
.br
The version has the format [\fIepoch\fP\fB:\fP\f(CR]\fP\fIversion\fP[\fB\-\fP\fIrelease\fP].
.br
Example: \fBversion: < 0:0.11.4\-2\fP
.RE
.sp
\fBsolvable_name\fP
.RS 4
name of object (e.g. zypper)
.RE
.sp
\fBsolvable_summary\fP
.RS 4
summary of object
.RE
.sp
\fBsolvable_arch\fP
.RS 4
architecture of object (e.g. x86_64, i586)
.RE
.sp
\fBsolvable_description\fP
.RS 4
description of object
.RE
.sp
\fBsolvable_eula\fP
.RS 4
license text of objects which request accepting license by user
.RE
.sp
\fBsolvable_license\fP
.RS 4
license of package (only for package) (e.g. GPL2)
.RE
.sp
\fBsolvable_keywords\fP
.RS 4
keywords which specify package (only for package)
.RE
.sp
\fBsolvable_authors\fP
.RS 4
authors of package (only for package)
.RE
.sp
\fBsolvable_group\fP
.RS 4
package group (only for package) (e.g. Development/Tools/Version Control )
.RE
.sp
\fBupdate_reference_type\fP
.RS 4
reference for update (e.g. bugzilla,cve) (only for patches)
.RE
.SH "EXAMPLES"
.sp
\fBExact Package\fP
.RS 4
This is the way YaST UI does it. Lock k3b (e.g. you don\(cqt want to update it).
.RE
.sp
.if n .RS 4
.nf
.fam C
\-\-\-\-\-locks\-\-\-\-\-
type: package
solvable_name: k3b
match_type: exact
case_sensitive: on
.fam
.fi
.if n .RE
.sp
\fBPackage Wildcard\fP
.RS 4
This is the way "zypper addlock cross\-*\-gcc\-icecream\-backend" does it.
.RE
.sp
.if n .RS 4
.nf
.fam C
\-\-\-\-\-locks\-\-\-\-\-
type: package
solvable_name: cross\-*\-gcc\-icecream\-backend
match_type: glob
case_sensitive: on
.fam
.fi
.if n .RE
.sp
\fBVersioned Lock\fP
.RS 4
Do not install new GCC. This format is used when converting from the openSUSE\-10.3 lock format.
.RE
.sp
.if n .RS 4
.nf
.fam C
\-\-\-\-\-locks\-\-\-\-\-
solvable_name: gcc
match_type: glob
version: > 4.2
.fam
.fi
.if n .RE
.sp
\fBAnything named KDE\fP
.RS 4
Locks everything which contains kde in the name.
.RE
.sp
.if n .RS 4
.nf
.fam C
\-\-\-\-\-locks\-\-\-\-\-
solvable_name: kde
.fam
.fi
.if n .RE
.sp
\fBAnything mentioning KDE\fP
.RS 4
Locks everything which contains kde in the name, summary, or description.
.RE
.sp
.if n .RS 4
.nf
.fam C
\-\-\-\-\-locks\-\-\-\-\-
query_string: kde
solvable_name:
solvable_summary:
solvable_description:
.fam
.fi
.if n .RE
.SH "HOMEPAGE"
.sp
This manual page only covers the most important attributes. The complete list is available at \c
.URL "http://en.opensuse.org/Libzypp/Locksfile" "" ""
.SH "AUTHORS"
.sp
Josef Reidinger \c
.MTO "jreidinger\(atsuse.cz" "" ""
Manual page contributions by Martin Vidner \c
.MTO "mvidner\(atsuse.cz" "" "."
.SH "SEE ALSO"
.sp
zypper(8)