Commit Graph

533 Commits

Author SHA1 Message Date
Matthias Clasen
afc87ad1e5 Add a history command
The history command pulls the transaction log entries
out of the journal, and presents them nicely.

We use the sd-journal api for this, so we need to
link against libsystemd now, but we make the dependency
optional. If libsystemd is not available, the history
command will simply print an error.
2018-10-11 14:51:51 +02:00
Alexander Larsson
99fbbc25c6 build-finish: Inherit permissions from runtime by default
In version 0.99.1 (065053775b) flatpak
stopped inheriting permissions from the runtime, because that made
the story about application permissions way to complicated. What
we want is to have a static set of permissions for the app that
is frozen at install time.

However, inheriting permissions from the runtime makes a lot of sense
as certain permissions are required from the runtime, in particular this
is used by the kde runtime to read the kdeglobals file, etc.

So, to combine the best of the two worlds, we now do inherit permissions,
but at build-time (and you can disable it if you want). This way
kde apps don't have to repeat themselves, but we still get static
application permissions.

Closes: #2230
Approved by: alexlarsson
2018-10-10 15:40:58 +00:00
Matthias Clasen
e5d74a7d74 docs: Fix alphabetic ordering of commands
The permissions were misplaced.

Closes: #2218
Approved by: alexlarsson
2018-10-10 15:26:23 +00:00
Matthias Clasen
24141bd093 Remove --show-columns leftovers
When I decided to add --columns without --show-columns,
I remove the option everywhere. Almost. These are the
leftovers I forgot.

Closes: #2227
Approved by: alexlarsson
2018-10-10 14:56:57 +00:00
Matthias Clasen
e9ffa9dda6 remote-ls: Show runtimes
Add a runtime column that shows the runtime an application
is using, and add an --app-runtime option to allow filtering
by the used runtime.

Closes: #2224
Approved by: alexlarsson
2018-10-10 10:29:08 +00:00
Matthias Clasen
f79c9c7539 Document the SuggestRemoteName key
Found it missing from the docs while writing tests.

Closes: #2199
Approved by: alexlarsson
2018-10-10 08:03:35 +00:00
Matthias Clasen
36d5134e97 enter: Allow giving application ID
With the instance infrastructure, we can go from
the ID of a running application to its monitor PID,
so we can accept the application ID here. Whats more,
we can offer completion for it.

Note that completion only works if you use sudo -E,
since the flatpak used for complcations needs to see
the session environment to find running instances.

Closes: #2181
Approved by: alexlarsson
2018-10-10 06:28:28 +00:00
Matthias Clasen
9c84b88e46 Add a kill command
This sends SIGKILL to a running sandbox process.
The command has completion for running applications,
for both application IDs and instance IDs.

Closes: #2180

Closes: #2181
Approved by: alexlarsson
2018-10-10 06:28:28 +00:00
Matthew Leeds
36bce67618 Merge pull request #2204 from matthiasclasen/repair-docs
repair: Refer to ostree fsck
2018-10-09 17:13:18 -07:00
Matthew Leeds
df19efe1b2 doc/build-update-repo: Fix a typo 2018-10-09 14:17:31 -07:00
Matthias Clasen
dd546ad365 Make FlatpakInstance api public
This can be of use in frontends like GNOME Software.

Closes: #2201
Approved by: alexlarsson
2018-10-08 08:36:23 +00:00
Matthias Clasen
ec49776416 repair: Refer to ostree fsck
Add a mention of ostree fsck to the flatpak repair man page,
so people know there are more alternatives.
2018-10-06 16:53:52 -04:00
Matthias Clasen
170a8774bc remote-ls: Add --columns option
This is more flexible than --show-details.

Closes: #2090
Approved by: alexlarsson
2018-10-05 15:19:43 +00:00
Matthias Clasen
f8c69e5b01 remotes: Add a --columns option
This is more flexible than --show-details.

Closes: #2090
Approved by: alexlarsson
2018-10-05 15:19:43 +00:00
Matthias Clasen
c0d858748b list: Add a --columns option
This is more flexible than --show-details.

Closes: #2090
Approved by: alexlarsson
2018-10-05 15:19:43 +00:00
Matthias Clasen
6a199ddeb4 ps: Port to column helpers
Closes: #2090
Approved by: alexlarsson
2018-10-05 15:19:43 +00:00
Matthias Clasen
789cc1ea60 repo: Update the docs
Mention --commits, and refer to build-update-repo
and ostree as alternative commands for repo management.

Closes: #2156
Approved by: alexlarsson
2018-10-05 13:49:52 +00:00
Matthias Clasen
f3a3ea9c67 list: Add an option to filter by runtime
This lets you use list --app --app-runtime=org.gnome.Platform//3.24
to see which apps on your system still depend on this old runtime.

Closes: #2175
Approved by: alexlarsson
2018-10-05 13:36:33 +00:00
Alexander Larsson
35b92d7237 Support --allow=canbus for AF_CAN access
This fixes https://github.com/flatpak/flatpak/issues/2176

Closes: #2179
Approved by: alexlarsson
2018-10-03 14:31:30 +00:00
Robert McQueen
8bd22682f7 installation: nitpicks
Make the new _run_triggers function appear correctly in GtkDoc and cross-link.

Closes: #2164
Approved by: alexlarsson
2018-10-02 06:22:27 +00:00
Matthias Clasen
dd7a163a28 run: Document new options
Document --user, --system nd --installation.

Closes: #2158
Approved by: alexlarsson
2018-10-01 13:05:12 +00:00
Matthias Clasen
d83adbc71a docs: Document environment variable handling
Mention how flatpak run handles environment variables,
and include the blacklist of variables we always override.

Closes: #2141
Approved by: alexlarsson
2018-09-27 07:29:18 +00:00
Matthias Clasen
ff55756478 Explain fallback-x11
This socket option was not explained anywere. Add
a sentence to flatpak-build-finish.1 to explain it.

Closes: #2063
Approved by: alexlarsson
2018-09-04 10:10:51 +00:00
Matthias Clasen
c284777d61 Add more api docs for libflatpak
Bring the library docs much closer to completion.

Closes: #2053
Approved by: alexlarsson
2018-09-03 10:31:51 +00:00
Matthias Clasen
be36b88def Document all known .flatpak-info keys
Some of the keys in the Instance group were missing.
Add them to the man page.

Closes: #2051
Approved by: alexlarsson
2018-08-31 06:58:32 +00:00
Matthias Clasen
e832e7d5c2 override: Add a --show option
This option shows the contents of an override file. If an appid
is given, it shows overrides for that app, otherwise
the global overrides.

Closes: #2041
Approved by: alexlarsson
2018-08-29 14:58:15 +00:00
Matthias Clasen
b8daf08ea8 override: Add a --reset option
This option removes an override file. If an appid
is given, it removes overrides for that app, otherwise
the global overrides.

Closes: #2041
Approved by: alexlarsson
2018-08-29 14:58:15 +00:00
Matthias Clasen
a2e57cb6aa Document the child-pid column
Make the world a better place, with docs.

Closes: #2039
Approved by: alexlarsson
2018-08-29 14:46:47 +00:00
Matthias Clasen
03bb003f0f flatpak ps: Match uniqe prefixes of column names
So much more convenient to say 'app' than 'application'.

Closes: #2027
Approved by: alexlarsson
2018-08-28 07:51:12 +00:00
Matthias Clasen
ad49ca758c flatpak ps: Support commit as field
Add support for commit and runtime-commit.
We shorten these to 12 characters, as we do
elsewhere.

Closes: #2027
Approved by: alexlarsson
2018-08-28 07:51:12 +00:00
Matthias Clasen
3f5ce0e945 Document flatpak ps
Closes: #2023
Approved by: alexlarsson
2018-08-27 14:25:15 +00:00
Matthias Clasen
a2069e75df Fix up the flatpak-create-usb man page
There were some copy-paste leftovers here.

Closes: #2018
Approved by: alexlarsson
2018-08-27 11:36:56 +00:00
Will Thompson
9e02d51737 docs: fix title of FlatpakBundleRef section
Closes: #1995
Approved by: alexlarsson
2018-08-27 10:57:16 +00:00
Will Thompson
9cc72ed08f transaction: improve cross-refs for signal parameter docs
Closes: #1995
Approved by: alexlarsson
2018-08-27 10:57:16 +00:00
Will Thompson
98ee688b84 docs: make FlatpakTransactionOperation appear
There were two reasons why no docs for this class appeared in the HTML
documentation:

* flatpak-transaction-operation.xml was not included by
  flatpak-docs.xml.
* all its symbols were listed in <SUBSECTION Standard>, which is hidden
  from the HTML output. It appears that if a section has no visible
  symbols, it's omitted.

Many symbols which belong to FlatpakTransaction were erroneously grouped
with FlatpakTransactionOperation and so also hidden; fix this too.

Closes: #1995
Approved by: alexlarsson
2018-08-27 10:57:15 +00:00
Matthew Leeds
76a5c63c19 doc/flatpak-build-bundle.xml: Add a usage example
In the output of `flatpak build-bundle --help` it's not clear what
LOCATION is, so the least we can do is add an example of its usage to
the man page. At some point it would be nice to also have explanations
of positional arguments in help output.

Closes: #1974
Approved by: alexlarsson
2018-08-17 08:24:33 +00:00
Owen W. Taylor
d7d05a8619 Use oci+http[s]:// as an URL to identify OCI registries
The old pattern of using a separate 'OCI' flag was very ugly
internally in the code once it was extended to flatpak bundles and
flatpakrefs - using a different URI scheme means that the nature
of the remote can't be accidentally lost in some part of the code.

Probing would be possible as well, but would make it difficult to
add a remote when offline, and also doesn't deal well with the
fact that our data layout is different for the two types of remotes -
the type of remote could change at any point!

As a side effect this change enables flatpakrefs and flatpak bundles for OCI
registries.
2018-08-13 11:23:28 +02:00
Alexander Larsson
f176d3eba3 Add --disable-fsync to build-export and build-commit-from
This mirrors ostree commit --disable-fsync and is useful in some cases.
For instance, we'd like to use it when building the temporary import
repositories in flathub.

Closes: #1951
Approved by: alexlarsson
2018-08-09 13:12:42 +00:00
Matthew Leeds
1e75e645f1 create-usb: Automatically update the repo summary
Copying refs from the system repo into a repo on a USB drive requires
the summary in the system repo to be up to date (and similarly for other
flatpak installations like a per-user one). At the moment we expect the
user to run `sudo ostree summary -u` before `flatpak create-usb` which
is a bad user experience. Another option is to set
`core.auto-update-summary` to true on the ostree repo config, but there
are significant performance concerns with that: it involves updating the
summary after every transaction rather than only when we need it. So
this commit changes the create-usb command to use the "UpdateSummary"
system-helper method to update the summary in the source repo before
copying to the destination. This strategy allows us to continue to let
non-root users use `flatpak create-usb`. This commit also tries to
update the remote repo metadata and appstream data for each remote
before copying to the USB, because we can now do that without
invalidating the summary.

Closes: #1945
Approved by: alexlarsson
2018-08-08 14:42:16 +00:00
Alexander Larsson
2d3f493f27 run: Add --die-with-parent to run
This is similare to the already existing arg in flatpak build.

Closes: #1946
Approved by: alexlarsson
2018-08-08 12:09:14 +00:00
Matthias Clasen
e03c61ebbc Add file format docs to flatpak.1
The flatpak.1 man page serves as an overview page that lists
all the individual command man pages. Make it a complete
overview by listing the file format man pages as well.

Closes: #1944
Approved by: alexlarsson
2018-08-07 09:30:30 +00:00
Matthias Clasen
97f2e3a3fa Merge pull request #1929 from flatpak/autoprune-unless-docs
doc: Document the autoprune-unless metadata key
2018-07-27 18:54:19 -04:00
Matthew Leeds
59997dd126 doc: Document the autoprune-unless metadata key 2018-07-27 12:47:08 -07:00
P. F. Chimento
fbd84d93e4 manpage: Refer to flatpak-metadata documentation
The documentation for extension info can be found there.

See #1341.

Closes: #1927
Approved by: mwleeds
2018-07-27 19:27:19 +00:00
Matthew Leeds
425385d3ea fixup! doc: Add a man page for the repair command 2018-07-17 12:20:44 -07:00
Matthew Leeds
af10bb98ec doc: Add a man page for the repair command
Add a man page based on one of the comments in
app/flatpak-builtins-repair.c

Fixes https://github.com/flatpak/flatpak/issues/1820
2018-07-16 17:43:12 -07:00
朝歌
d7b9d3fc2b Update flatpak-document-unexport.xml
Closes: #1896
Approved by: mwleeds
2018-07-12 11:41:52 +00:00
Matthew Leeds
8aaacaac50 doc: Fix another typo 2018-07-11 17:58:13 +02:00
Matthew Leeds
6a49f65b6a doc: Fix a typo 2018-07-11 17:54:52 +02:00
Matthew Leeds
7decfe39ae doc: Fix my typos 2018-07-10 19:30:58 +02:00