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

CONFIGURATION

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

FILES

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