1OSTREE COMMIT(1)                 ostree commit                OSTREE COMMIT(1)
2
3
4

NAME

6       ostree-commit - Commit a new revision
7

SYNOPSIS

9       ostree commit [OPTIONS...] --branch= {BRANCH} [PATH]
10

DESCRIPTION

12       This allows you to commit changes to a branch. The specification of the
13       branch is required. The command will print the checksum of a successful
14       commit.
15

OPTIONS

17       --subject, -s="SUBJECT"
18           One line subject. (optional)
19
20       --body, -m="BODY"
21           Full description. (optional)
22
23       --body-file, -F="FILE"
24           Full commit description from a file. (optional)
25
26       --editor, -e
27           Open a text editor for the commit description. It will use
28           OSTREE_EDITOR, VISUAL, EDITOR, or vi, in descending order of
29           preference. The commit will be aborted if the message is left
30           empty.
31
32       --branch, -b="BRANCH"
33           Branch. Required, unless --orphan is given.
34
35       --parent="COMMIT"
36           Parent checksum or "none" to explicitly use no parent. If not
37           specified, BRANCH is used as parent (no parent in case BRANCH does
38           not exist).
39
40       --tree="dir=PATH" or "tar=TARFILE" or "ref=COMMIT"
41           Overlay the given argument as a tree. When committing an archive,
42           the TARFILE can be specified as - to read the archive from standard
43           input.
44
45       --base="REV"
46           Start from the content in a commit. This differs from
47           --tree=ref=REV in that no commit modifiers are applied. This is
48           usually what you want when creating a derived commit. This is also
49           used for --selinux-policy-from-base.
50
51       --add-metadata-string="KEY=VALUE"
52           Add a key/value pair to metadata. Can be specified multiple times.
53
54       --add-metadata="KEY=VALUE"
55           Add a key/value pair to metadata, where the KEY is a string, and
56           VALUE is g_variant_parse() formatted. Can be specified multiple
57           times.
58
59       --keep-metadata="KEY"
60           Keep metadata KEY and its associated VALUE from parent. Can be
61           specified multiple times.
62
63       --add-detached-metadata-string="KEY=VALUE"
64           Add a key/value pair to detached metadata.
65
66       --owner-uid="UID"
67           Set file ownership user id.
68
69       --owner-gid="GID"
70           Set file ownership group id.
71
72       --no-xattrs
73           Do not import extended attributes.
74
75       --bootable
76           Inject standard metadata for a bootable Linux filesystem tree.
77
78       --link-checkout-speedup
79           Optimize for commits of trees composed of hardlinks into the
80           repository.
81
82       --tar-autocreate-parents
83           When loading tar archives, automatically create parent directories
84           as needed.
85
86       --skip-if-unchanged
87           If the contents are unchanged from previous commit, do nothing.
88
89       --consume
90           When committing from a local directory (i.e. not an archive or
91           --tree=ref), assume ownership of the content. This may simply
92           involve deleting it, but if possible, the content may simply be
93           rename()ed into the repository rather than creating a new copy.
94
95       --statoverride="PATH"
96           File containing list of modifications to make permissions (file
97           mode in decimal, followed by space, followed by file path). The
98           specified mode is ORed with the file's original mode unless
99           preceded by "=".
100
101       --skip-list="PATH"
102           File containing list of file paths to skip (one path per line).
103
104       --table-output
105           Output more information in a KEY: VALUE format.
106
107       --generate-sizes
108           Generate size information along with commit metadata.
109
110       --gpg-sign="KEY-ID"
111           GPG Key ID with which to sign the commit (if have GPGME - GNU
112           Privacy Guard Made Easy).
113
114       --gpg-homedir="HOMEDIR"
115           GPG home directory to use when looking for keyrings (if have GPGME
116           - GNU Privacy Guard Made Easy).
117
118       --timestamp="TIMESTAMP"
119           Override the timestamp of the commit to TIMESTAMP.
120
121       --orphan
122           Create a commit without writing to a ref (branch)
123
124       --fsync="POLICY"
125           POLICY is a boolean which specifies whether fsync should be used or
126           not. Default to true.
127
128       -s, --sign-type
129           Use particular signature engine. Currently available ed25519 and
130           dummy signature types. The default is ed25519.
131
132       --sign="KEY-ID"
133           There KEY-ID is:
134
135           for ed25519:
136               base64-encoded secret key for commit signing.
137
138           for dummy:
139               ASCII-string used as secret key.
140
141

EXAMPLE

143       $ ostree commit --branch=my-branch --subject="Initial commit"
144
145                   67e382b11d213a402a5313e61cbc69dfd5ab93cb07fbb8b71c2e84f79fa5d7dc
146
147
148
149OSTree                                                        OSTREE COMMIT(1)
Impressum