Content-type: text/html; charset=UTF-8
APPSTREAMCLI
Section: appstream-cli (1)Updated:
Index Return to Main Contents
NAME
appstreamcli - Handle AppStream metadata and the AppStream indexSYNOPSIS
- appstreamcli [COMMAND]
DESCRIPTION
appstreamcli is a small helper tool to work with AppStream metadata and access the AppStream component index from the command-line. The AppStream component index contains a list of all available software components for your distribution, matched to their package names. It is generated using AppStream XML or Debian DEP-11 data, which is provided by your distributor.
For more information about the AppStream project and the other components which are part of it, take a look at the AppStream pages at m[blue]Freedesktop.orgm[][1].
OPTIONS
status
- Display various information about the installed metadata and the metadata cache.
get ID
- Get a component by it's identifier.
s, search TERM
- Search the AppStream component database for a given search term.
what-provides TYPE TERM
-
Return components which provide a given item. An item type can be specified using the
TYPE
parameter, a value to search for has to be supplied using the
TERM
parameter.
Examples:
Get components which handle the "text/xml" mimetype.
appstreamcli what-provides mimetype "text/xml"
Get component which provides the "libfoo.so.2" library.
appstreamcli what-provides lib libfoo.so.2
refresh, refresh-cache
-
Trigger a database refresh, if necessary. In case you want to force the database to be rebuilt, supply the
--force
flag.
This command must be executed with root permission.
dump ID
- Dump the XML description of a component with the given ID.
validate FILES
-
Validate AppStream XML metadata for compliance with the specification.
Both XML metadata types, upstream and distro XML, are handled. The filetype which should be validated is determined automatically.
The --pedantic flag triggers a more pedantic validation of the file, including minor and style issues in the report.
validate-tree DIRECTORY
-
Validate AppStream XML metadata found in a file-tree.
This performs a standard validation of all found metadata, but also checks for additional errors, like the presence of .desktop files and validity of other additional metadata.
install ID
-
Install a software component by its ID.
This resolves the AppStream component ID to the package name which provides it and then calls the distribution's package manager to install the software.
This feature is experimental.
put FILE
- Install a metadata file into the right directory on the current machine.
new-template TYPE FILE
-
Create a metainfo file template to be used by software projects. The
--from-desktop
option can be used to use a .desktop file as template for generating the example file.
The generated files contain example entries which need to be filed in with the actual desired values by the project author.
The first TYPE parameter is the name of an AppStream component type. For a complete list check out m[blue]the documentationm[][2] or the help output of appstreamcli for this subcommand.
--details
- Print out more information about a found component.
--no-color
- Don't print colored output.
--no-net
-
Do not access the network when validating metadata.
The same effect can be achieved by setting the AS_VALIDATE_NONET environment variable before running appstreamcli.
--version
- Display the version number of appstreamcli
SEE ALSO
AUTHOR
This manual page was written by Matthias Klumpp <matthias@tenstral.net>.
COPYRIGHT
Copyright © 2012-2016 Matthias Klumpp
NOTES
- 1.
- Freedesktop.org
- 2.
-
the documentation
Index
This document was created by man2html, using the manual pages.
Time: 04:45:25 GMT, September 16, 2022
![[MAN] git-http-fetch](https://blogger.googleusercontent.com/img/a/AVvXsEitfznRjvReRJUdd4v4tRKeHPIiY6C4DkbiRpW4pB5OZ0x9kOjfQtTv9Fi2i8IjVLmzastSRdRDORdabWA1dlnhBibT-DKKkYqYuonPtC15h6_o6d10zPAjZ9qQkn4NfICnrEMX-4XvPMJpiSKALSp7wLwGfP05yapMjWQCy8wvQRVQyUokHrQllrbd=w72-h72-p-k-no-nu)
0 댓글