fedora-third-party(1)

1fedora-third-party(1)       General Commands Manual      fedora-third-party(1)
2
3
4

NAME

6       fedora-third-party - manage third-party software repositories
7
8

SYNOPOSIS

10       fedora-third-party [--verbose | -v] COMMAND [ARGS]
11
12

DESCRIPTION

14       The  fedora-third-party  tool  is  used  to manage third-party software
15       repositories that are distributed with editions of  Fedora  Linux,  but
16       not enabled unless the user opts-in.
17
18

COMMON OPTIONS

20       The following options are understood:
21
22
23       --verbose, v
24
25
26       Print detailed information about what is being done.
27
28

COMMANDS

30       The following commands are understood:
31
32
33   enable [--config-only]
34       Enables  third-party  repositories. Configured DNF repositories are en‐
35       abled, and configured Flatpak remotes are created unless  they  already
36       exist.
37
38
39       If  --config-only is specified, existing repositories are not modified,
40       but the configuration is updated so that newly added repositories  will
41       be enabled when fedora-third-party refresh is called.
42
43
44   disable [--config-only]
45       Disables third-party repositories. Configured DNF repositories are dis‐
46       abled.  Configured Flatpak remotes are removed, unless:
47
48
49              • the remote previously existed and was not created  by  fedora-
50                third-party.
51
52              • there  are  Flatpak applications or runtimes already installed
53                from the remote
54
55              • the remote has been  modified  to  remove  a  filter  and  the
56                keep_unfiltered flag is configured for the remote.
57
58
59
60       The  last  exception exists because, if a Fedora third-party repository
61       has a filter (see flatpak-remote-add(1)), this filter will  be  removed
62       if the user installs a .flatpakrepo file for the same remote name with‐
63       out a filter.  At this point, the remote is  different  from  what  was
64       distributed with the Fedora edition and should be left untouched.
65
66
67       If  --config-only is specified, existing repositories are not modified,
68       but the configuration is updated so that newly added repositories  will
69       not be enabled when fedora-third-party refresh is called.
70
71
72   query [--quiet | -q]
73       Prints  a  human-readable  string  describing  the  whether third-party
74       repositories hae been enabled.
75
76
77       When --quiet is specified, no output is  printed,  and  the  status  is
78       given  by  the exit code (0 for enabled, 1 for disabled, 2 for disabled
79       if no selection has yet been made).
80
81
82   refresh
83       Look for newly added third-party repository definitions, and if  third-
84       party  repositories  are  enabled,  enable  DNF repositories and create
85       Flatpak remotes.
86
87
88   list [-a | --all | --csv | --columns=col1,col2]
89       Prints the list of currently configured repositories. By  default,  the
90       list will be pretty-printed in tabular form with headers. The --csv op‐
91       tion can be used to switch the output to  comma-separated-value  format
92       without headers.
93
94
95       The  columns to be printed can be specified with the --columns options.
96       Currently supported values are name for  the  name  of  the  repository
97       (which is the same as the DNF repository name or Flatpak remote name)),
98       and type for the type of the repository (either dnf or flatpak).
99
100
101       --columns should always be specified together with --csv to get  stable
102       output  -  the default set of columns may change. With the current col‐
103       umns, you can assume that the values will not be quoted.
104
105
106       Flatpak repositories with the keep_unfiltered option set are hidden  by
107       default  from  the list if there is a matching remote without a filter.
108       a or --all can be passed to show all repositories.
109
110

CONFIGURATION

112       Repositories  are  configured  by   files   in   /usr/lib/fedora-third-
113       party/conf.d.   All files in this directory ending with .conf are read.
114       Each section found defines a repository that should  be  controlled  by
115       fedora-third-party.
116
117
118       Example of configuration for a DNF repository:
119
120
121              [somerepo]
122              # The DNF repository must match and also be 'somerepo'
123              type=dnf
124
125
126
127       Example of configuration for a Flatpak remote:
128
129
130              [somerepo]
131              # The Flatpak remote must match and also be 'somerepo'
132              type=flatpak
133
134              # Path to a flatpakrepo file defining the remote. If it's a relative
135              # path, it will be interpreted relative to the directory where the
136              # config file is.
137              flatpakrepo=somerepo.flatpakrepo
138              # If present, 'fedora-third-party disable' will leave this repository
139              # untouched if it has been modified to not have a filter, and it will
140              # also be hidden from the output of 'fedora-third-party list'
141              keep_unfiltered=yes
142
143
144

FILES

146       /usr/lib/fedora-third-party/conf.d - repository configuration files
147
148
149       /var/lib/fedora-third-party/state  -  current  state  is stored in this
150       file.
151
152