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       --selinux-labeling-epoch0 | 1
76           When SELinux labeling is enabled, epoch 1 ensures that /usr/etc is
77           labeled as if it was /etc.
78
79       --bootable
80           Inject standard metadata for a bootable Linux filesystem tree.
81
82       --link-checkout-speedup
83           Optimize for commits of trees composed of hardlinks into the
84           repository.
85
86       --tar-autocreate-parents
87           When loading tar archives, automatically create parent directories
88           as needed.
89
90       --skip-if-unchanged
91           If the contents are unchanged from previous commit, do nothing.
92
93       --consume
94           When committing from a local directory (i.e. not an archive or
95           --tree=ref), assume ownership of the content. This may simply
96           involve deleting it, but if possible, the content may simply be
97           rename()ed into the repository rather than creating a new copy.
98
99       --statoverride="PATH"
100           File containing list of modifications to make permissions (file
101           mode in decimal, followed by space, followed by file path). The
102           specified mode is ORed with the file's original mode unless
103           preceded by "=".
104
105       --skip-list="PATH"
106           File containing list of file paths to skip (one path per line).
107
108       --table-output
109           Output more information in a KEY: VALUE format.
110
111       --generate-sizes
112           Generate size information along with commit metadata.
113
114       --gpg-sign="KEY-ID"
115           GPG Key ID with which to sign the commit (if have GPGME - GNU
116           Privacy Guard Made Easy).
117
118       --gpg-homedir="HOMEDIR"
119           GPG home directory to use when looking for keyrings (if have GPGME
120           - GNU Privacy Guard Made Easy).
121
122       --timestamp="TIMESTAMP"
123           Override the timestamp of the commit to TIMESTAMP.
124
125       --orphan
126           Create a commit without writing to a ref (branch)
127
128       --fsync="POLICY"
129           POLICY is a boolean which specifies whether fsync should be used or
130           not. Default to true.
131
132       -s, --sign-type
133           Use particular signature engine. Currently available ed25519 and
134           dummy signature types. The default is ed25519.
135
136       --sign-from-file="PATH"
137           This will read a key (corresponding to the provided --sign-type
138           from the provided path. The key should be base64 encoded.
139
140       --sign="KEY-ID"
141           In new code, avoid using this because passing private keys via
142           command line arguments are prone to leakage in logs and process
143           listings.
144
145           The KEY-ID is:
146
147           for ed25519:
148               base64-encoded secret key for commit signing.
149
150           for dummy:
151               ASCII-string used as secret key.
152
153

EXAMPLE

155       $ ostree commit --branch=my-branch --subject="Initial commit"
156
157                   67e382b11d213a402a5313e61cbc69dfd5ab93cb07fbb8b71c2e84f79fa5d7dc
158
159
160
161OSTree                                                        OSTREE COMMIT(1)