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, followed by space, followed by file path).
98
99       --skip-list="PATH"
100           File containing list of file paths to skip (one path per line).
101
102       --table-output
103           Output more information in a KEY: VALUE format.
104
105       --generate-sizes
106           Generate size information along with commit metadata.
107
108       --gpg-sign="KEY-ID"
109           GPG Key ID with which to sign the commit (if have GPGME - GNU
110           Privacy Guard Made Easy).
111
112       --gpg-homedir="HOMEDIR"
113           GPG home directory to use when looking for keyrings (if have GPGME
114           - GNU Privacy Guard Made Easy).
115
116       --timestamp="TIMESTAMP"
117           Override the timestamp of the commit to TIMESTAMP.
118
119       --orphan
120           Create a commit without writing to a ref (branch)
121
122       --fsync="POLICY"
123           POLICY is a boolean which specifies whether fsync should be used or
124           not. Default to true.
125
126       -s, --sign-type
127           Use particular signature engine. Currently available ed25519 and
128           dummy signature types. The default is ed25519.
129
130       --sign="KEY-ID"
131           There KEY-ID is:
132
133           for ed25519:
134               base64-encoded secret key for commit signing.
135
136           for dummy:
137               ASCII-string used as secret key.
138
139

EXAMPLE

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