1OSC(1) Generated Python Manual OSC(1)
2
6 osc - OpenSUSE Commander
7
9 osc [global opts] <command> [--help] [opts] [args]
10
12 openSUSE commander is a command-line interface to the Open Build Ser‐
13 vice. Type 'osc <subcommand> --help' for help on a specific subcom‐
14 mand.
15 For additional information, see * http://en.opensuse.org/open‐
17 SUSE:Build_Service_Tutorial * http://en.opensuse.org/openSUSE:OSC
18 You can modify osc commands, or roll your own, via the plugin API: *
20 http://en.opensuse.org/openSUSE:OSC_plugins
21
24 -v, --verbose
25 increase verbosity
26 -q, --quiet
29 be quiet, not verbose
30 --debugger
33 jump into the debugger before executing anything
34 --post-mortem
37 jump into the debugger in case of errors
38 --traceback
41 print call trace in case of errors
42 -H, --http-debug
45 debug HTTP traffic (filters some headers)
46 --http-full-debug
49 debug HTTP traffic (filters no headers)
50 --debug
53 print info useful for debugging
54 -A URL/alias, --apiurl URL/alias
57 specify URL to access API server at or an alias
58 --config FILE
61 specify alternate configuration file
62 --no-keyring
65 disable usage of desktop keyring system
66
69 osc add
70 Mark files to be added upon the next commit
71 usage: osc [global opts] add [-h] [-f]
73 In case a URL is given the file will get downloaded and registered to
75 be downloaded by the server as well via the download_url source ser‐
76 vice.
77 This is recommended for release tar balls to track their source and to
79 help others to review your changes esp. on version upgrades.
80 usage:
82 osc add URL [URL...]
83 osc add FILE [FILE...]
84 options:
86 -f, --force
88 add files even if they are excluded by the exclude_glob
89 config option
90 osc addchannels
93 Add channels to project
94 usage: osc [global opts] addchannels [-h] [-s] [-e]
96 The command adds all channels which are defined to be used for a given
98 source package. The source link target is used to lookup the channels.
99 The command can be used for a certain package or for all in the speci‐
100 fied project.
101 In case no channel is defined the operation is just returning.
103 Examples:
105 osc addchannels [PROJECT [PACKAGE]]
106 options:
108 -s, --skip-disabled
110 Skip disabled channels. Otherwise the source gets added,
111 but not the repositories.
112 -e, --enable-all
115 Enable all added channels including the ones disabled by
116 default.
117 osc addcontainers
120 Add maintained containers for a give package
121 usage: osc [global opts] addcontainers [-h] [--extend-package-names]
123 The command adds all containers which are marked as maintained and con‐
125 tain an rpm originating from the specified source package.
126 Examples:
128 osc addcontainers [PROJECT PACKAGE]
129 options:
131 --extend-package-names
133 Extend packages names with project name as suffix
134 osc addremove (ar)
137 Adds new files, removes disappeared files
138 usage: osc [global opts] addremove [-h] [-r]
140 Adds all files new in the local copy, and removes all disappeared
142 files.
143 ARG, if specified, is a package working copy.
145 options:
147 -r, --recursive
149 If CWD is a project dir then scan all package dirs as
150 well
151 osc aggregatepac
154 "Aggregate" a package to another package
155 usage: osc [global opts] aggregatepac [-h] [--nosources]
157 [-m SRC=TARGET[,SRC=TARGET]] [-d]
158 Aggregation of a package means that the build results (binaries) of a
160 package are basically copied into another project. This can be used to
161 make packages available from building that are needed in a project but
162 available only in a different project. Note that this is done at the
163 expense of disk space. See http://en.opensuse.org/openSUSE:Build_Ser‐
164 vice_Tips_and_Tricks#link_and_aggregate for more information.
165 The DESTPAC name is optional; the source packages' name will be used if
167 DESTPAC is omitted.
168 usage:
170 osc aggregatepac SOURCEPRJ SOURCEPAC[:FLAVOR] DESTPRJ [DESTPAC]
171 options:
173 --nosources
175 ignore source packages when copying build results to des‐
176 tination project
177 -m SRC=TARGET[,SRC=TARGET], --map-repo SRC=TARGET[,SRC=TARGET]
180 Allows repository mapping(s) to be given as SRC=TAR‐
181 GET[,SRC=TARGET]
182 -d, --disable-publish
185 disable publishing of the aggregated package
186 osc api
189 Issue an arbitrary request to the API
190 usage: osc [global opts] api [-h] [-X HTTP_METHOD] [-e] [-d STRING] [-T
192 FILE]
193 [-a NAME STRING NAME STRING]
194 url
195 Useful for testing.
197 URL can be specified either partially (only the path component), or
199 fully with URL scheme and hostname ('http://...').
200 Note the global -A and -H options (see osc help).
202 Examples:
204 osc api /source/home:user
205 osc api -X PUT -T /etc/fstab source/home:user/test5/myfstab
206 osc api -e /configuration
207 arguments:
209 url either URL '/path' or full URL with 'scheme://host‐
211 name/path'
212 options:
215 -X HTTP_METHOD, -m HTTP_METHOD, --method HTTP_METHOD
217 specify HTTP method to use (GET|PUT|DELETE|POST)
218 -e, --edit
221 GET, edit and PUT the location
222 -d STRING, --data STRING
225 specify string data for e.g. POST
226 -T FILE, -f FILE, --file FILE
229 specify filename to upload, uses PUT mode by default
230 -a NAME STRING NAME STRING, --add-header NAME STRING NAME STRING
233 add the specified header to the request
234 osc branch (getpac, bco, branchco)
237 Branch a package
238 usage: osc [global opts] branch [-h] [--nodevelproject] [-c] [-f]
240 [--add-repositories] [--extend-pack‐
241 age-names]
242 [--noaccess] [-m TEXT] [-M] [-N] [-r
243 rev]
244 [--linkrev linkrev]
245 [--add-repositories-block add_reposito‐
246 ries_block]
247 [--add-repositories-rebuild add_reposi‐
248 tories_rebuild]
249 [--disable-build]
250 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
252 information on this topic.]
253 Create a source link from a package of an existing project to a new
255 subproject of the requesters home project (home:branches:)
256 The branched package will live in
258 home:USERNAME:branches:PROJECT/PACKAGE if nothing else specified.
259 With getpac or bco, the branched package will come from one of
261 %(getpac_default_project)s (list of projects from oscrc:getpac_de‐
262 fault_project) if nothing else is specfied on the command line.
263 In case of branch errors, where the source has currently merge con‐
265 flicts use --linkrev=base option.
266 usage:
268 osc branch
269 osc branch SOURCEPROJECT SOURCEPACKAGE
270 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT|.
271 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT|. TARGETPACK‐
272 AGE
273 osc getpac SOURCEPACKAGE
274 osc bco ...
275 options:
277 --nodevelproject
279 do not follow a defined devel project (primary project
280 where a package is developed)
281 -c, --checkout
284 Checkout branched package afterwards using "co -e
285 -S"('osc bco' is a shorthand for this option)
286 -f, --force
289 force branch, overwrite target
290 --add-repositories
293 Add repositories to target project (happens by default
294 when project is new)
295 --extend-package-names
298 Extend packages names with project name as suffix
299 --noaccess
302 Create a hidden project
303 -m TEXT, --message TEXT
306 specify message TEXT
307 -M, --maintenance
310 Create project and package in maintenance mode
311 -N, --new-package
314 create a branch pointing to a not yet existing package
315 -r rev, --revision rev
318 branch against a specific revision
319 --linkrev linkrev
322 specify the used revision in the link target.
323 --add-repositories-block add_repositories_block
326 specify the used block strategy for new repositories
327 --add-repositories-rebuild add_repositories_rebuild
330 specify the used rebuild strategy for new repositories
331 --disable-build
334 disable building of the branched package
335 osc browse
338 Opens browser
339 usage: osc [global opts] browse [-h]
341 usage:
343 osc browse [PROJECT [PACKAGE]]
344 osc build (wipe, shell, chroot)
346 Build a package on your local machine
347 usage: osc [global opts] build [-h] [--clean] [-o] [-l]
349 [--no-changelog]
350 [--rsync-src RSYNCSRCPATH]
351 [--rsync-dest RSYNCDESTPATH]
352 [--overlay OVERLAY] [--noinit]
353 [--nochecks]
354 [--no-verify] [--nodebugpackages]
355 [--noservice]
356 [-p DIR] [-k DIR] [-M FLAVOR] [-x PAC]
357 [-X FILE] [--root ROOT] [-j N] [-t N]
358 [--icecream N] [--ccache]
359 [--pkg-ccache /path/to/_ccache.tar]
360 [--sccache]
361 [--sccache-uri redis://127.0.0.1:6389]
362 [--with X] [--without X] [--define 'X
363 Y']
364 [--build-opt OPT] [--userootforbuild]
365 [--build-uid uid:gid|"caller"]
366 [--local-package] [--stage STAGE]
367 [--linksources] [--vm-memory MEMORY]
368 [--vm-disk-size DISKSIZE] [--vm-type
369 TYPE]
370 [--vm-telnet TELNET] [--target TARGET]
371 [--alternative-project PROJECT] [-d]
372 [--disable-debuginfo] [-b] [--release N]
373 [--disable-cpio-bulk-download]
374 [--download-api-only] [--oldpackages
375 DIR]
376 [--verbose-mode MODE] [--shell-af‐
377 ter-fail]
378 [--shell-cmd COMMAND] [-f] [--host HOST]
379 [--trust-all-projects] [--nopreinstal‐
380 limage]
381 The command works from a package checkout (local changes are fine).
383 You can use `osc repos` to look up REPOSITORY and ARCH arguments. If
385 they are not set, `osc` choses from configured repos in this priority:
386 1. `build_repository` mentioned in config file
387 2. "standard"
388 3. "openSUSE_Factory"
389 4. "openSUSE_Tumbleweed"
390 5. last repo from the sorted list
391 BUILD_DESCR is either a RPM spec file, or a Debian dsc file.
393 The command honors packagecachedir, build-root and build-uid settings
395 in oscrc, if present. You may want to set su-wrapper = 'sudo' in oscrc,
396 and configure sudo with option NOPASSWD for /usr/bin/build.
397 If neither --clean nor --noinit is given, build will reuse an existing
399 build-root again, removing unneeded packages and add missing ones. This
400 is usually the fastest option.
401 If the package doesn't exist on the server please use the --local-pack‐
403 age option. If the project of the package doesn't exist on the server
404 use the --alternative-project <alternative-project> option. Example:
405 osc build [OPTS] --alternative-project openSUSE:10.3 standard i586
406 BUILD_DESCR
407 usage:
409 osc build [OPTS] # will try to guess a build
410 environement
411 osc build [OPTS] REPOSITORY ARCH BUILD_DESCR
412 osc build [OPTS] REPOSITORY ARCH
413 osc build [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR is de‐
414 tected automatically)
415 osc build [OPTS] ARCH (REPOSITORY = build_repository (config op‐
416 tion), BUILD_DESCR is detected automatically)
417 osc build [OPTS] BUILD_DESCR (REPOSITORY = build_repository (config
418 option), ARCH = hostarch)
419 osc build [OPTS] (REPOSITORY = build_repository (config option),
420 ARCH = hostarch, BUILD_DESCR is detected automatically)
421 For debugging after a build you can jump into the build environment:
423 osc shell [OPTS] REPOSITORY ARCH
424 Run a single command inside of the build environment:
426 osc shell --shell-cmd=COMMAND [OPTS] REPOSITORY ARCH
427 Useful `shell` OPTS
429 --noinit # for faster run
430 --shell-cmd=COMMAND
431 --shell-after-fail
432 --extra-pkgs=PACKAGE # install additional packages
433 To clean up the build environment run
435 osc wipe [OPTS]
436 osc wipe [OPTS] REPOSITORY ARCH
437 If you've set the used VM type in oscrc, it can be also overridden here
439 --vm-type=chroot # for faster, but uncleaner and unsecure build
441 --vm-type=kvm # for clean and secure build
442 --vm-type=qemu # for slow cross architecture build using sys‐
443 tem emulator
444 # Note: # Configuration can be overridden by envvars, e.g. #
446 OSC_SU_WRAPPER overrides the setting of su-wrapper. # OSC_BUILD_ROOT
447 overrides the setting of build-root. # OSC_PACKAGECACHEDIR overrides
448 the setting of packagecachedir.
449 options:
451 --clean
453 Delete old build root before initializing it
454 -o, --offline
457 Start with cached prjconf and packages without contacting
458 the api server
459 -l, --preload
462 Preload all files into the cache for offline operation
463 --no-changelog
466 don't update the package changelog from a changes file
467 --rsync-src RSYNCSRCPATH
470 Copy folder to buildroot after installing all RPMs. Use
471 together with --rsync-dest. This is the path on the HOST
472 filesystem e.g. /tmp/linux-kernel-tree. It defines RSYNC‐
473 DONE 1 .
474 --rsync-dest RSYNCDESTPATH
477 Copy folder to buildroot after installing all RPMs. Use
478 together with --rsync-src. This is the path on the TARGET
479 filesystem e.g. /usr/src/packages/BUILD/linux-2.6 .
480 --overlay OVERLAY
483 Copy overlay filesystem to buildroot after installing all
484 RPMs .
485 --noinit, --no-init
488 Skip initialization of build root and start with build
489 immediately.
490 --nochecks, --no-checks
493 Do not run build checks on the resulting packages.
494 --no-verify, --noverify
497 Skip signature verification (via pgp keys) of packages
498 used for build. (Global config in oscrc: no_verify)
499 --nodebugpackages, --no-debug-packages
502 Skip installation of additional debug packages for CLI
503 builds
504 --noservice, --no-service
507 Skip run of local source services as specified in _ser‐
508 vice file.
509 -p DIR, --prefer-pkgs DIR
512 Prefer packages from this directory when installing the
513 build-root
514 -k DIR, --keep-pkgs DIR
517 Save built packages into this directory
518 -M FLAVOR, --multibuild-package FLAVOR
521 Only work with the specified flavor of a multibuild pack‐
522 age.
523 -x PAC, --extra-pkgs PAC
526 Add this package when installing the build-root
527 -X FILE, --extra-pkgs-from FILE
530 Add packages listed in this file when installing the
531 build-root
532 --root ROOT
535 Build in specified directory
536 -j N, --jobs N
539 Compile with N jobs
540 -t N, --threads N
543 Compile with N threads
544 --icecream N
547 use N parallel build jobs with icecream
548 --ccache
551 use ccache to speed up rebuilds
552 --pkg-ccache /path/to/_ccache.tar
555 path to an existing uncompressed archive ccache. Using
556 this option implies --ccache
557 --sccache
560 use sccache to speed up rebuilds. Conflicts with --cache
561 --sccache-uri redis://127.0.0.1:6389
564 Optional remote URI for sccache storage. Implies --sc‐
565 cache.
566 --with X
569 enable feature X for build
570 --without X
573 disable feature X for build
574 --define 'X Y'
577 define macro X with value Y
578 --build-opt OPT
581 pass option OPT to the build command
582 --userootforbuild, --login-as-root
585 Run build or shell as root. The default is to build as
586 unprivileged user. Note that a line "# norootforbuild" in
587 the spec file will invalidate this option.
588 --build-uid uid:gid|"caller"
591 specify the numeric uid:gid pair to assign to the unpriv‐
592 ileged "abuild" user or use "caller" to use the current
593 user uid:gid
594 --local-package
597 build a package which does not exist on the server
598 --stage STAGE
601 runs a specific stage, default is "a" for all. Append a
602 trailing "="to only run the specified stage. Append a
603 trailing "+" to runthe specified stage and all stages
604 coming after it. With nosuffix, stages up to and included
605 the specified stage are run.
606 --linksources
609 use hard links instead of a deep copied source
610 --vm-memory MEMORY
613 amount of memory for VM defined in MB
614 --vm-disk-size DISKSIZE
617 size for newly created disk image in MB
618 --vm-type TYPE
621 use VM type TYPE (e.g. kvm)
622 --vm-telnet TELNET
625 Launch a telnet server inside of VM build
626 --target TARGET
629 define target platform
630 --alternative-project PROJECT
633 specify the build target project
634 -d, --debuginfo
637 also build debuginfo sub-packages
638 --disable-debuginfo
641 disable build of debuginfo packages
642 -b, --baselibs
645 Create -32bit/-64bit/-x86 rpms for other architectures
646 --release N
649 set release number of the package to N
650 --disable-cpio-bulk-download
653 disable downloading packages as cpio archive from api
654 --download-api-only
657 only fetch packages from the api
658 --oldpackages DIR
661 take previous build from DIR (special values: _self,
662 _link)
663 --verbose-mode MODE
666 set verbose mode of the "build" program, arguments can be
667 "all" or "vm"
668 --shell-after-fail
671 run a shell if the build tool fails
672 --shell-cmd COMMAND
675 run specified command instead of bash
676 -f, --force
679 Do not ask for confirmation to wipe
680 --host HOST
683 perform the build on a remote server - user@server:~/re‐
684 mote/directory
685 --trust-all-projects
688 trust packages from all projects
689 --nopreinstallimage, --no-preinstallimage
692 Do not use preinstall images for creating the build root.
693 osc buildconfig
696 Shows the build config
697 usage: osc [global opts] buildconfig [-h]
699 Shows the build configuration which is used in building a package.
701 This command is mostly used internally by the 'build' command.
702 The returned data is the project-wide build configuration in a format
704 which is directly readable by the build script. It contains RPM macros
705 and BuildRequires expansions, for example.
706 The argument REPOSITORY an be taken from the first column of the
708 usage:
710 osc buildconfig REPOSITORY (in pkg or prj dir)
711 osc buildconfig PROJECT REPOSITORY
712 osc buildhistory (buildhist)
714 Shows the build history of a package
715 usage: osc [global opts] buildhistory [-h] [--csv] [-l limit] [-M FLA‐
717 VOR]
718 The arguments REPOSITORY and ARCH can be taken from the first two col‐
720 umns of the 'osc repos' output.
721 usage:
723 osc buildhist REPOSITORY ARCHITECTURE
724 osc buildhist PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCHITECTURE
725 options:
727 --csv generate output in CSV (separated by |)
729 -l limit, --limit limit
732 for setting the number of results
733 -M FLAVOR, --multibuild-package FLAVOR
736 Only work with the specified flavor of a multibuild pack‐
737 age.
738 osc buildinfo
741 Shows the build info
742 usage: osc [global opts] buildinfo [-h] [--alternative-project PROJECT]
744 [-d]
745 [-M FLAVOR] [-x PAC] [-p DIR]
746 Shows the build "info" which is used in building a package. This com‐
748 mand is mostly used internally by the 'build' subcommand. It needs to
749 be called from within a package directory.
750 The BUILD_DESCR argument is optional. BUILD_DESCR is a local RPM spec‐
752 file or Debian "dsc" file. If specified, it is sent to the server, and
753 the buildinfo will be based on it. If the argument is not supplied, the
754 buildinfo is derived from the specfile which is currently on the source
755 repository server.
756 The returned data is XML and contains a list of the packages used in
758 building, their source, and the expanded BuildRequires.
759 The arguments REPOSITORY and ARCH are optional. They can be taken from
761 the first two columns of the 'osc repos' output. If not specified,
762 REPOSITORY defaults to the 'build_repository' config entry in your 'os‐
763 crc' and ARCH defaults to your host architecture.
764 usage:
766 in a package working copy:
767 osc buildinfo [OPTS] REPOSITORY ARCH BUILD_DESCR
768 osc buildinfo [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR
769 is detected automatically)
770 osc buildinfo [OPTS] ARCH (REPOSITORY = build_repository (con‐
771 fig option), BUILD_DESCR is detected automatically)
772 osc buildinfo [OPTS] BUILD_DESCR (REPOSITORY = build_repository
773 (config option), ARCH = hostarch)
774 osc buildinfo [OPTS] (REPOSITORY = build_repository (config op‐
775 tion), ARCH = hostarch, BUILD_DESCR is detected automatically)
776 Note: if BUILD_DESCR does not exist locally the remote
777 BUILD_DESCR is used
778 osc buildinfo [OPTS] PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH
780 [BUILD_DESCR]
781 options:
783 --alternative-project PROJECT
785 specify the build target project
786 -d, --debug
789 verbose output of build dependencies
790 -M FLAVOR, --multibuild-package FLAVOR
793 Only work with the specified flavor of a multibuild pack‐
794 age.
795 -x PAC, --extra-pkgs PAC
798 Add this package when computing the buildinfo
799 -p DIR, --prefer-pkgs DIR
802 Prefer packages from this directory when installing the
803 build-root
804 osc buildlog (buildlogtail, blt, bl)
807 Shows the build log of a package
808 usage: osc [global opts] buildlog [-h] [-l] [--lastsucceeded] [-M FLA‐
810 VOR]
811 [-o OFFSET] [-s]
812 Shows the log file of the build of a package. Can be used to follow the
814 log while it is being written. Needs to be called from within a pack‐
815 age directory.
816 When called as buildlogtail (or blt) it just shows the end of the log‐
818 file. This is useful to see just a build failure reasons.
819 The arguments REPOSITORY and ARCH are the first two columns in the 'osc
821 results' output. If the buildlog url is used buildlog command has the
822 same behavior as remotebuildlog.
823 buildlog [REPOSITORY ARCH | BUILDLOGURL]
825 options:
827 -l, --last
829 Show the last finished log file
830 --lastsucceeded, --last-succeeded
833 Show the last succeeded log file
834 -M FLAVOR, --multibuild-package FLAVOR
837 Only work with the specified flavor of a multibuild pack‐
838 age.
839 -o OFFSET, --offset OFFSET
842 get log start or end from the offset
843 -s, --strip-time
846 strip leading build time from the log
847 osc cat (less, blame)
850 Output the content of a file to standard output
851 usage: osc [global opts] cat [-h] [-r rev] [-e] [-u] [-D] [-M]
853 Examples:
855 osc cat file
856 osc cat project package file
857 osc cat project/package/file
858 osc cat http://api.opensuse.org/build/.../_log
859 osc cat http://api.opensuse.org/source/../_link
860 osc less file
862 osc less project package file
863 osc blame file
865 osc blame project package file
866 options:
868 -r rev, --revision rev
870 print out the specified revision
871 -e, --expand
874 (default) force expansion of linked packages.
875 -u, --unexpand
878 always work with unexpanded packages.
879 -D, --deleted
882 access file in a deleted package
883 -M, --meta
886 list meta data files
887 osc changedevelrequest (changedevelreq, cr)
890 Create request to change the devel package definition
891 usage: osc [global opts] changedevelrequest [-h] [-m TEXT]
893 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
895 information on this topic.]
896 See the "request" command for showing and modifying existing requests.
898 usage:
900 osc changedevelrequest PROJECT PACKAGE DEVEL_PROJECT [DEVEL_PACK‐
901 AGE]
902 options:
904 -m TEXT, --message TEXT
906 specify message TEXT
907 osc checkconstraints
910 Check the constraints and view compliant workers
911 usage: osc [global opts] checkconstraints [-h] [--ignore-file]
913 Checks the constraints for compliant workers.
915 usage:
917 remote request:
918 osc checkconstraints [OPTS] PROJECT PACKAGE REPOSITORY ARCH
919 in a package working copy:
921 osc checkconstraints [OPTS] REPOSITORY ARCH CONSTRAINTSFILE
922 osc checkconstraints [OPTS] CONSTRAINTSFILE
923 osc checkconstraints [OPTS]
924 options:
926 --ignore-file
928 ignore _constraints file and only check project con‐
929 straints
930 osc checkout (co)
933 Check out content from the repository
934 usage: osc [global opts] checkout [-h] [-r rev] [-e] [-D] [-u] [-M]
936 [-c]
937 [-o outdir] [-s] [-S] [-l limit_size]
938 Check out content from the repository server, creating a local working
940 copy.
941 When checking out a single package, the option --revision can be used
943 to specify a revision of the package to be checked out.
944 When a package is a source link, then it will be checked out in ex‐
946 panded form. If --unexpand-link option is used, the checkout will in‐
947 stead produce the raw _link file plus patches.
948 usage:
950 osc co PROJECT [PACKAGE] [FILE]
951 osc co PROJECT # entire project
952 osc co PROJECT PACKAGE # a package
953 osc co PROJECT PACKAGE FILE # single file -> to current
954 dir
955 while inside a project directory:
957 osc co PACKAGE # check out PACKAGE from
958 project
959 with the result of rpm -q --qf '%%{DISTURL}\n' PACKAGE
961 osc co obs://API/PROJECT/PLATFORM/REVISION-PACKAGE
962 options:
964 -r rev, --revision rev
966 checkout the specified revision. NOTE: if you checkout
967 the complete project this option is ignored!
968 -e, --expand-link
971 if a package is a link, check out the expanded sources
972 (no-op, since this became the default)
973 -D, --deleted
976 checkout an already deleted package. No meta information
977 -u, --unexpand-link
980 if a package is a link, check out the _link file instead
981 of the expanded sources
982 -M, --meta
985 checkout out meta data instead of sources
986 -c, --current-dir
989 place PACKAGE folder in the current directory instead of
990 a PROJECT/PACKAGE directory
991 -o outdir, --output-dir outdir
994 place package in the specified directory instead of a
995 PROJECT/PACKAGE directory
996 -s, --source-service-files
999 Run source services.
1000 -S, --server-side-source-service-files
1003 Use server side generated sources instead of local gener‐
1004 ation.
1005 -l limit_size, --limit-size limit_size
1008 Skip all files with a given size
1009 osc clean
1012 Removes all untracked files from the package working copy
1013 usage: osc [global opts] clean [-h] [-n]
1015 Examples:
1017 osc clean <path>
1018 Note: if <path> is omitted it defaults to '.' (<path> has to be a pack‐
1020 age working copy)
1021 Warning: This command removes all files with status '?'.
1023 options:
1025 -n, --dry-run
1027 print the results without actually removing a file
1028 osc cleanassets (ca)
1031 Clean all previous downloaded assets
1032 usage: osc [global opts] cleanassets [-h]
1034 This is useful to prepare a new git commit.
1036 osc comment
1038 List / create / delete comments
1039 usage: osc [global opts] comment [-h] [-c COMMENT] [-p PARENT]
1041 On create:
1043 If -p is given a reply to the ID is created. Otherwise
1044 a toplevel comment is created.
1045 If -c is not given the default editor will be opened and
1046 you can type your comment
1047 usage:
1049 osc comment list package PROJECT PACKAGE
1050 osc comment list project PROJECT
1051 osc comment list request REQUEST_ID
1052 osc comment create [-p PARENT_ID] [-c COMMENT] package PROJECT
1054 PACKAGE
1055 osc comment create [-p PARENT_ID] [-c COMMENT] project PROJECT
1056 osc comment create [-p PARENT_ID] [-c COMMENT] request REQUEST_ID
1057 osc comment delete ID
1059 options:
1061 -c COMMENT, --comment COMMENT
1063 comment text
1064 -p PARENT, --parent PARENT
1067 reply to comment with parent id
1068 osc commit (checkin, ci)
1071 Upload content to the repository server
1072 usage: osc [global opts] commit [-h] [-m TEXT] [-n] [-F FILE] [-f]
1074 [--skip-local-service-run]
1075 Upload content which is changed in your working copy, to the repository
1077 server.
1078 examples:
1080 osc ci # current dir
1081 osc ci <dir>
1082 osc ci file1 file2 ...
1083 options:
1085 -m TEXT, --message TEXT
1087 specify log message TEXT
1088 -n, --no-message
1091 do not specify a log message
1092 -F FILE, --file FILE
1095 read log message from FILE, '-' denotes standard input.
1096 -f, --force
1099 force commit, even if there were no changes
1100 --skip-local-service-run, --noservice
1103 Skip service run of configured source services for local
1104 run
1105 osc config
1108 Get/set a config option
1109 usage: osc [global opts] config [-h] [-d] [-s] [-p] [--change-password]
1111 [--select-password-store] [--no-echo]
1112 [--dump]
1113 [--dump-full]
1114 Examples:
1116 osc config section option (get current value)
1117 osc config section option value (set to value)
1118 osc config section option --delete (delete option/reset to the de‐
1119 fault)
1120 osc config section --change-password (changes the password in sec‐
1121 tion "section")
1122 (section is either an apiurl or an alias or 'general')
1123 osc config --dump (dump the complete configuration)
1124 options:
1126 -d, --delete
1128 delete option from config or reset option to the default)
1129 -s, --stdin
1132 indicates that the config value should be read from stdin
1133 -p, --prompt
1136 prompt for a value
1137 --change-password
1140 Change password
1141 --select-password-store
1144 Change the password store
1145 --no-echo
1148 prompt for a value but do not echo entered characters
1149 --dump dump the complete configuration (without 'pass' and
1152 'passx' options)
1153 --dump-full
1156 dump the complete configuration (including 'pass' and
1157 'passx' options)
1158 osc copypac
1161 Copy a package
1162 usage: osc [global opts] copypac [-h] [-c] [-k] [-K] [-d] [-r rev] [-t
1164 URL]
1165 [-m TEXT] [-e]
1166 A way to copy package to somewhere else.
1168 It can be done across buildservice instances, if the -t option is used.
1170 In that case, a client-side copy and link expansion are implied.
1171 Using --client-side-copy always involves downloading all files, and up‐
1173 loading them to the target.
1174 The DESTPAC name is optional; the source packages' name will be used if
1176 DESTPAC is omitted.
1177 If SOURCEPRJ or DESTPRJ is '.' it will be expanded to the PRJ of the
1179 current directory.
1180 usage:
1182 osc copypac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC]
1183 options:
1185 -c, --client-side-copy
1187 do a (slower) client-side copy
1188 -k, --keep-maintainers
1191 keep original maintainers. Default is remove all and re‐
1192 place with the one calling the script.
1193 -K, --keep-link
1196 If the target package is a link, the link is kept, but
1197 may be updated. If the source package is a link, its ex‐
1198 panded version is considered.
1199 -d, --keep-develproject
1202 keep develproject tag in the package metadata
1203 -r rev, --revision rev
1206 copy the specified revision.
1207 -t URL, --to-apiurl URL
1210 URL of destination api server. Default is the source api
1211 server.
1212 -m TEXT, --message TEXT
1215 specify message TEXT
1216 -e, --expand
1219 if the source package is a link then copy the expanded
1220 version of the link
1221 osc create-pbuild-config (cpc)
1224 This command is creating the necessary files to build using pbuild
1225 tool.
1226 usage: osc [global opts] create-pbuild-config [-h] repository arch
1228 It basically creates _config and _pbuild file in the project directory.
1230 Changes from there can not get submitted back, except the project is
1231 managed in git.
1232 Examples:
1234 osc cpc REPOSITORY ARCH
1235 arguments:
1237 repository
1239 arch
1242 osc createincident
1245 Create a maintenance incident
1246 usage: osc [global opts] createincident [-h] [-a ATTRIBUTE] [--noac‐
1248 cess]
1249 [-m TEXT]
1250 [See https://openbuildservice.org/help/manu‐
1252 als/obs-user-guide/cha.obs.maintenance_setup.html for information on
1253 this topic.]
1254 This command is asking to open an empty maintenance incident. This can
1256 usually only be done by a responsible maintenance team. Please see the
1257 "mbranch" command on how to full such a project content and the "patch‐
1258 info" command how add the required maintenance update information.
1259 usage:
1261 osc createincident [ MAINTENANCEPROJECT ]
1262 options:
1264 -a ATTRIBUTE, --attribute ATTRIBUTE
1266 Use this attribute to find default maintenance project
1267 (default is OBS:MaintenanceProject)
1268 --noaccess
1271 Create a hidden project
1272 -m TEXT, --message TEXT
1275 specify message TEXT
1276 osc createrequest (creq)
1279 Create multiple requests with a single command
1280 usage: osc [global opts] createrequest [-h] [-m TEXT] [-r REV] [-s RE‐
1282 QUEST_ID]
1283 [--nodevelproject] [--cleanup]
1284 [--no-cleanup] [--no-update]
1285 [--yes]
1286 usage:
1288 osc creq [OPTIONS] [
1289 -a submit SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
1290 -a delete PROJECT [PACKAGE]
1291 -a change_devel PROJECT PACKAGE DEVEL_PROJECT [DEVEL_PACKAGE]
1292 -a add_me ROLE PROJECT [PACKAGE]
1293 -a add_group GROUP ROLE PROJECT [PACKAGE]
1294 -a add_role USER ROLE PROJECT [PACKAGE]
1295 -a set_bugowner USER PROJECT [PACKAGE]
1296 ]
1297 Option -m works for all types of request, the rest work only for
1299 submit.
1300 Example:
1302 osc creq -a submit -a delete home:someone:branches:openSUSE:Tools
1303 -a change_devel openSUSE:Tools osc home:someone:branches:openSUSE:Tools
1304 -m ok
1305 This will submit all modified packages under current directory,
1307 delete project home:someone:branches:openSUSE:Tools and change the de‐
1308 vel project to home:someone:branches:openSUSE:Tools for package osc in
1309 project openSUSE:Tools.
1310 options:
1312 -m TEXT, --message TEXT
1314 specify message TEXT
1315 -r REV, --revision REV
1318 for "create", specify a certain source revision ID (the
1319 md5 sum)
1320 -s REQUEST_ID, --supersede REQUEST_ID
1323 Superseding another request by this one
1324 --nodevelproject
1327 do not follow a defined devel project (primary project
1328 where a package is developed)
1329 --cleanup
1332 remove package if submission gets accepted (default for
1333 home:<id>:branch projects)
1334 --no-cleanup
1337 never remove source package on accept, but update its
1338 content
1339 --no-update
1342 never touch source package on accept (will break source
1343 links)
1344 --yes proceed without asking.
1347 osc delete (remove, del, rm)
1350 Mark files or package directories to be deleted upon the next 'checkin'
1351 usage: osc [global opts] delete [-h] [-f]
1353 usage:
1355 cd .../PROJECT/PACKAGE
1356 osc delete FILE [...]
1357 cd .../PROJECT
1358 osc delete PACKAGE [...]
1359 This command works on check out copies. Use "rdelete" for working on
1361 server side only. This is needed for removing the entire project.
1362 As a safety measure, projects must be empty (i.e., you need to delete
1364 all packages first).
1365 If you are sure that you want to remove a package and all its files use
1367 '--force' switch. Sometimes this also works without --force.
1368 options:
1370 -f, --force
1372 forces removal of entire package and its files
1373 osc deleterequest (deletereq, droprequest, dropreq, dr)
1376 Request to delete (or 'drop') a package or project
1377 usage: osc [global opts] deleterequest [-h] [-m TEXT] [-r REPOSITORY]
1379 [--all]
1380 [--accept-in-hours HOURS]
1381 usage:
1383 osc deletereq [-m TEXT] # works in checked out
1384 project/package
1385 osc deletereq [-m TEXT] PROJECT PACKAGE
1386 osc deletereq [-m TEXT] PROJECT [--all|--repository REPOSITORY]
1387 options:
1389 -m TEXT, --message TEXT
1391 specify message TEXT
1392 -r REPOSITORY, --repository REPOSITORY
1395 specify repository
1396 --all deletes entire project with packages inside
1399 --accept-in-hours HOURS
1402 specify time when request shall get accepted automati‐
1403 cally. Only works with write permissions in target.
1404 osc dependson
1407 Dependson shows the build dependencies inside of a project, valid for a
1408 given repository and architecture
1409 usage: osc [global opts] dependson [-h]
1411 The command can be used to find build dependencies (wrt. a given repos‐
1413 itory and arch) that reside in the same project. To see all build de‐
1414 pendencies use the buildinfo command.
1415 This is no guarantee, since the new build might have changed dependen‐
1417 cies.
1418 NOTE: to see all binary packages, which can trigger a build you need to
1420 refer the buildinfo, since this command shows only the dependen‐
1421 cies
1422 inside of a project.
1423 The arguments REPOSITORY and ARCH can be taken from the first two col‐
1425 umns of the 'osc repos' output.
1426 usage in package or project directory:
1428 osc dependson REPOSITORY ARCH
1429 usage:
1431 osc dependson PROJECT [PACKAGE] REPOSITORY ARCH
1432 osc detachbranch
1434 Replace a link with its expanded sources
1435 usage: osc [global opts] detachbranch [-h] [-m TEXT]
1437 If a package is a link it is replaced with its expanded sources. The
1439 link does not exist anymore.
1440 usage:
1442 osc detachbranch # from a package working copy
1443 osc detachbranch PROJECT PACKAGE
1444 options:
1446 -m TEXT, --message TEXT
1448 specify message TEXT
1449 osc develproject (dp, bsdevelproject)
1452 Print the devel project / package of a package
1453 usage: osc [global opts] develproject [-h]
1455 Examples:
1457 osc develproject [PROJECT PACKAGE]
1458 osc diff (di, ldiff, linkdiff)
1460 Generates a diff
1461 usage: osc [global opts] diff [-h] [-c rev] [-r rev1[:rev2]] [-M] [-p]
1463 [-l]
1464 [--missingok] [-u]
1465 Generates a diff, comparing local changes against the repository
1467 server.
1468 usage:
1470 ARG, if specified, is a filename to include in the diff.
1471 Default: all files.
1472 osc diff --link
1474 osc linkdiff
1475 Compare current checkout directory against the link base.
1476 osc diff --link PROJ PACK
1478 osc linkdiff PROJ PACK
1479 Compare a package against the link base (ignoring working copy
1480 changes).
1481 options:
1483 -c rev, --change rev
1485 the change made by revision rev (like -r rev-1:rev).If
1486 rev is negative this is like -r rev:rev-1.
1487 -r rev1[:rev2], --revision rev1[:rev2]
1490 If rev1 is specified it will compare your working copy
1491 against the revision (rev1) on the server. If rev1 and
1492 rev2 are specified it will compare rev1 against rev2
1493 (NOTE: changes in your working copy are ignored in this
1494 case)
1495 -M, --meta
1498 operate on meta files
1499 -p, --plain
1502 output the diff in plain (not unified) diff format
1503 -l, --link
1506 (osc linkdiff): compare against the base revision of the
1507 link
1508 --missingok
1511 do not fail if the source or target project/package does
1512 not exist on the server
1513 -u, --unexpand
1516 Local changes only, ignore changes in linked package
1517 sources
1518 osc distributions (dists)
1521 Shows all available distributions
1522 usage: osc [global opts] distributions [-h]
1524 This command shows the available distributions. For active distribu‐
1526 tions it shows the name, project and name of the repository and a sug‐
1527 gested default repository name.
1528 usage:
1530 osc distributions
1531 osc downloadassets (da)
1533 Download all assets referenced in the build descriptions
1534 usage: osc [global opts] downloadassets [-h]
1536 osc enablechannels (enablechannel)
1538 Enables channels
1539 usage: osc [global opts] enablechannels [-h]
1541 Enables existing channel packages in a project. Enabling means adding
1543 the needed repositories for building. The command can be used to en‐
1544 able a specific one or all channels of a project.
1545 Examples:
1547 osc enablechannels [PROJECT [PACKAGE]]
1548 osc getbinaries
1550 Download binaries to a local directory
1551 usage: osc [global opts] getbinaries [-h] [-d DIR] [-M FLAVOR]
1553 [--sources]
1554 [--debuginfo] [--ccache]
1555 This command downloads packages directly from the api server. Thus, it
1557 directly accesses the packages that are used for building others even
1558 when they are not "published" yet.
1559 usage:
1561 osc getbinaries REPOSITORY # works
1562 in checked out project/package (check out all archs in subdirs)
1563 osc getbinaries REPOSITORY ARCHITECTURE # works
1564 in checked out project/package
1565 osc getbinaries PROJECT REPOSITORY ARCHITECTURE
1566 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE
1567 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE FILE
1568 options:
1570 -d DIR, --destdir DIR
1572 destination directory
1573 -M FLAVOR, --multibuild-package FLAVOR
1576 Get binaries from the specified flavor of a multibuild
1577 package. It is meant for use from a package checkout when
1578 it is not possible to specify package:flavor.
1579 --sources
1582 also fetch source packages
1583 --debuginfo
1586 also fetch debug packages
1587 --ccache
1590 allow fetching ccache archive
1591 osc help (?)
1594 Give detailed help on a specific sub-command
1595 usage: osc [global opts] help [-h]
1597 usage:
1599 %(prog)s [SUBCOMMAND]
1600 osc importsrcpkg
1602 Import a new package from a src.rpm
1603 usage: osc [global opts] importsrcpkg [-h] [-p project] [-n name] [-t
1605 title]
1606 [-d description]
1607 [--delete-old-files]
1608 [-c]
1609 srpm
1610 A new package dir will be created inside the project dir (if no project
1612 is specified and the current working dir is a project dir the package
1613 will be created in this project). If the package does not exist on the
1614 server it will be created too otherwise the meta data of the existing
1615 package will be updated (<title /> and <description />). The src.rpm
1616 will be extracted into the package dir. The files won't be committed
1617 unless you explicitly pass the --commit switch.
1618 SRPM is the path of the src.rpm in the local filesystem, or an URL.
1620 arguments:
1622 srpm
1624 options:
1627 -p project, --project project
1629 specify the path to a project
1630 -n name, --name name
1633 specify a package name
1634 -t title, --title title
1637 set a title
1638 -d description, --description description
1641 set the description of the package
1642 --delete-old-files
1645 delete existing files from the server
1646 -c, --commit
1649 commit the new files
1650 osc info
1653 Print information about a working copy
1654 usage: osc [global opts] info [-h]
1656 Print information about each ARG (default: '.') ARG is a working-copy
1658 path.
1659 osc init
1661 Initialize a directory as working copy
1662 usage: osc [global opts] init [-h] project [package] [scm_url]
1664 Initialize an existing directory to be a working copy of an (already
1666 existing) buildservice project/package.
1667 (This is the same as checking out a package and then copying sources
1669 into the directory. It does NOT create a new package. To create a pack‐
1670 age, use 'osc meta pkg ... ...')
1671 You wouldn't normally use this command.
1673 To get a working copy of a package (e.g. for building it or working on
1675 it, you would normally use the checkout command. Use "osc help check‐
1676 out" to get help for it.
1677 usage:
1679 osc init PRJ
1680 osc init PRJ PAC
1681 osc init PRJ PAC SCM_URL
1682 arguments:
1684 project
1686 package
1689 scm_url
1692 osc jobhistory (jobhist)
1695 Shows the job history of a project
1696 usage: osc [global opts] jobhistory [-h] [--csv] [-l limit] [-M FLAVOR]
1698 The arguments REPOSITORY and ARCH can be taken from the first two col‐
1700 umns of the 'osc repos' output.
1701 usage:
1703 osc jobhist REPOSITORY ARCHITECTURE (in project dir)
1704 osc jobhist PROJECT [PACKAGE[:FLAVOR]] REPOSITORY ARCHITECTURE
1705 options:
1707 --csv generate output in CSV (separated by |)
1709 -l limit, --limit limit
1712 for setting the number of results
1713 -M FLAVOR, --multibuild-package FLAVOR
1716 Only work with the specified flavor of a multibuild pack‐
1717 age.
1718 osc linkpac
1721 "Link" a package to another package
1722 usage: osc [global opts] linkpac [-h] [-C {add,copy,local}] [-c] [-r
1724 rev] [-f]
1725 [--disable-build] [-d] [-N]
1726 A linked package is a clone of another package, but plus local modifi‐
1728 cations. It can be cross-project.
1729 The TARGET_PACKAGE name is optional; the source packages' name will be
1731 used if TARGET_PACKAGE is omitted.
1732 Afterwards, you will want to 'checkout TARGET_PROJECT TARGET_PACKAGE'.
1734 To add a patch, add the patch as file and add it to the _link file.
1736 You can also specify text which will be inserted at the top of the spec
1737 file.
1738 See the examples in the _link file.
1740 NOTE: In case you want to fix or update another package, you should use
1742 the 'branch'
1743 command. A branch has correct repositories (and a link) setup up
1744 by default and
1745 will be cleaned up automatically after it was submitted back.
1746 usage:
1748 osc linkpac PROJECT PACKAGE TARGET_PROJECT [TARGET_PACKAGE]
1749 osc linkpac TARGET_PROJECT [TARGET_PACKAGE] # from a package
1750 checkout
1751 options:
1753 -C {add,copy,local}, --cicount {add,copy,local}
1755 cicount attribute in the link, known values are add,
1756 copy, and local, default in buildservice is currently
1757 add.
1758 -c, --current
1761 link fixed against current revision.
1762 -r rev, --revision rev
1765 link the specified revision.
1766 -f, --force
1769 overwrite an existing link file if it is there.
1770 --disable-build
1773 disable building of the linked package
1774 -d, --disable-publish
1777 disable publishing of the linked package
1778 -N, --new-package
1781 create a link to a not yet existing package
1782 osc linktobranch
1785 Convert a package containing a classic link with patch to a branch
1786 usage: osc [global opts] linktobranch [-h]
1788 This command tells the server to convert a _link with or without a
1790 project.diff to a branch. This is a full copy with a _link file point‐
1791 ing to the branched place.
1792 usage:
1794 osc linktobranch # from a package working copy
1795 osc linktobranch PROJECT PACKAGE
1796 osc list (LL, lL, ll, ls)
1798 List sources or binaries on the server
1799 usage: osc [global opts] list [-h] [-a ARCH] [-r REPO] [-b] [-e] [-u]
1801 [-l]
1802 [-D] [-M] [-R REVISION]
1803 Examples for listing sources:
1805 ls # list all projects (deprecated)
1806 ls / # list all projects
1807 ls . # take PROJECT/PACKAGE from current dir.
1808 ls PROJECT # list packages in a project
1809 ls PROJECT PACKAGE # list source files of package of a
1810 project
1811 ls PROJECT PACKAGE <file> # list <file> if this file exists
1812 ls -v PROJECT PACKAGE # verbosely list source files of package
1813 ls -l PROJECT PACKAGE # verbosely list source files of package
1814 ll PROJECT PACKAGE # verbosely list source files of package
1815 LL PROJECT PACKAGE # verbosely list source files of ex‐
1816 panded link
1817 With --verbose, the following fields will be shown for each item:
1819 MD5 hash of file
1820 Revision number of the last commit
1821 Size (in bytes)
1822 Date and time of the last commit
1823 Examples for listing binaries:
1825 ls -b PROJECT # list all binaries of a project
1826 ls -b PROJECT -a ARCH # list ARCH binaries of a project
1827 ls -b PROJECT -r REPO # list binaries in REPO
1828 ls -b PROJECT PACKAGE REPO ARCH
1829 usage:
1831 ls [PROJECT [PACKAGE]]
1832 ls -b [PROJECT [PACKAGE [REPO [ARCH]]]]
1833 options:
1835 -a ARCH, --arch ARCH
1837 specify architecture (only for binaries)
1838 -r REPO, --repo REPO
1841 specify repository (only for binaries)
1842 -b, --binaries
1845 list built binaries instead of sources
1846 -e, --expand
1849 expand linked package (only for sources)
1850 -u, --unexpand
1853 always work with unexpanded (source) packages
1854 -l, --long
1857 print extra information
1858 -D, --deleted
1861 show only the former deleted projects or packages
1862 -M, --meta
1865 list meta data files
1866 -R REVISION, --revision REVISION
1869 specify revision (only for sources)
1870 osc localbuildlog (lbl)
1873 Shows the build log of a local buildchroot
1874 usage: osc [global opts] localbuildlog [-h] [-o OFFSET] [-s]
1876 usage:
1878 osc lbl [REPOSITORY [ARCH]]
1879 osc lbl # show log of newest last local build
1880 options:
1882 -o OFFSET, --offset OFFSET
1884 get log starting from offset
1885 -s, --strip-time
1888 strip leading build time from the log
1889 osc lock
1892 Locks a project or package
1893 usage: osc [global opts] lock [-h] [-m TEXT]
1895 usage:
1897 osc lock PROJECT [PACKAGE]
1898 options:
1900 -m TEXT, --message TEXT
1902 specify log message TEXT
1903 osc log
1906 Shows the commit log of a package
1907 usage: osc [global opts] log [-h] [-r rev] [--csv] [--xml] [-D] [-M]
1909 usage:
1911 osc log (inside working copy)
1912 osc log remote_project [remote_package]
1913 options:
1915 -r rev, --revision rev
1917 show log of the specified revision
1918 --csv generate output in CSV (separated by |)
1921 --xml generate output in XML
1924 -D, --deleted
1927 work on deleted package
1928 -M, --meta
1931 checkout out meta data instead of sources
1932 osc maintainer (bugowner)
1935 Show maintainers according to server side configuration
1936 usage: osc [global opts] maintainer [-h] [-b] [-B] [-e] [--nodevelpro‐
1938 ject]
1939 [-D devel_project] [-a user]
1940 [--all]
1941 [-s user] [-S user] [-U USER] [-G
1942 GROUP]
1943 [-d user] [-r role] [-m MESSAGE]
1944 # Search for official maintained sources in OBS instance osc maintainer
1946 BINARY_OR_PACKAGE_NAME <options> osc maintainer -U <user> <options> osc
1947 maintainer -G <group> <options>
1948 # Lookup via containers osc maintainer <options> osc maintainer PRJ
1950 <options> osc maintainer PRJ PKG <options>
1951 The tool looks up the default responsible person for a certain project
1953 or package. When using with an OBS 2.4 (or later) server it is doing
1954 the lookup for a given binary according to the server side configura‐
1955 tion of default owners.
1956 The tool is also looking into devel packages and supports to fallback
1958 to the project in case a package has no defined maintainer.
1959 Please use "osc meta pkg" in case you need to know the definition in a
1961 specific container.
1962 PRJ and PKG default to current working-copy path.
1964 options:
1966 -b, --bugowner-only
1968 Show only the bugowner
1969 -B, --bugowner
1972 Show only the bugowner if defined, or maintainer other‐
1973 wise
1974 -e, --email
1977 show email addresses instead of user names
1978 --nodevelproject
1981 do not follow a defined devel project (primary project
1982 where a package is developed)
1983 -D devel_project, --devel-project devel_project
1986 define the project where this package is primarily devel‐
1987 oped
1988 -a user, --add user
1991 add a new person for given role ("maintainer" by default)
1992 --all list all found entries not just the first one
1995 -s user, --set-bugowner user
1998 Set the bugowner to specified person (or group via group:
1999 prefix)
2000 -S user, --set-bugowner-request user
2003 Set the bugowner to specified person via a request (or
2004 group via group: prefix)
2005 -U USER, --user USER
2008 All official maintained instances for the specified USER
2009 -G GROUP, --group GROUP
2012 All official maintained instances for the specified GROUP
2013 -d user, --delete user
2016 delete a maintainer/bugowner (can be specified via
2017 --role)
2018 -r role, --role role
2021 Specify user role
2022 -m MESSAGE, --message MESSAGE
2025 Define message as commit entry or request description
2026 osc maintenancerequest (mr)
2029 Create a request for starting a maintenance incident
2030 usage: osc [global opts] maintenancerequest [-h] [-a ATTRIBUTE] [-m
2032 TEXT]
2033 [--release-project RELEASE‐
2034 PROJECT]
2035 [--enforce-branching]
2036 [--no-cleanup] [--cleanup]
2037 [--incident INCIDENT]
2038 [--incident-project INCI‐
2039 DENT_PROJECT]
2040 [-s REQUEST_ID]
2041 [See https://openbuildservice.org/help/manu‐
2043 als/obs-user-guide/cha.obs.maintenance_setup.html for information on
2044 this topic.]
2045 This command is asking the maintenance team to start a maintenance in‐
2047 cident based on a created maintenance update. Please see the "mbranch"
2048 command on how to create such a project and the "patchinfo" command how
2049 add the required maintenance update information.
2050 usage:
2052 osc maintenancerequest [ SOURCEPROJECT [ SOURCEPACKAGES RELEASEPRO‐
2053 JECT ] ]
2054 osc maintenancerequest .
2055 The 2nd line when issued within a package directory provides a short
2057 cut to submit a single package (the one in the current directory) from
2058 the project of this package to be submitted to the release project this
2059 package links to. This syntax is only valid when specified from a pack‐
2060 age subdirectory.
2061 options:
2063 -a ATTRIBUTE, --attribute ATTRIBUTE
2065 Use this attribute to find default maintenance project
2066 (default is OBS:MaintenanceProject)
2067 -m TEXT, --message TEXT
2070 specify message TEXT
2071 --release-project RELEASEPROJECT
2074 Specify the release project
2075 --enforce-branching
2078 submit from a fresh branched project
2079 --no-cleanup
2082 do not remove source project on accept
2083 --cleanup
2086 do remove source project on accept
2087 --incident INCIDENT
2090 specify incident number to merge in
2091 --incident-project INCIDENT_PROJECT
2094 specify incident project to merge in
2095 -s REQUEST_ID, --supersede REQUEST_ID
2098 Superseding another request by this one
2099 osc mbranch (maintained, sm)
2102 Search or branch multiple instances of a package
2103 usage: osc [global opts] mbranch [-h] [-c] [-a ATTRIBUTE]
2105 [-u UPDATE_ATTRIBUTE] [--dryrun]
2106 [--noaccess]
2107 [--nodevelproject] [--version]
2108 This command is used for searching all relevant instances of packages
2110 and creating links of them in one project. This is esp. used for main‐
2111 tenance updates. It can also be used to branch all packages marked be‐
2112 fore with a given attribute.
2113 [See http://en.opensuse.org/openSUSE:Build_Service_Concept_Maintenance
2115 for information on this topic.]
2116 The branched package will live in
2118 home:USERNAME:branches:ATTRIBUTE:PACKAGE if nothing else specified.
2119 If osc maintained or sm is issued only the relevant instances of a
2121 package will be shown. No branch will be created. This is similar to
2122 osc mbranch --dryrun.
2123 usage:
2125 osc sm [SOURCEPACKAGE] [-a ATTRIBUTE]
2126 osc mbranch [ SOURCEPACKAGE [ TARGETPROJECT ] ]
2127 options:
2129 -c, --checkout
2131 Checkout branched package afterwards ('osc bco' is a
2132 shorthand for this option)
2133 -a ATTRIBUTE, --attribute ATTRIBUTE
2136 Use this attribute to find affected packages (default is
2137 OBS:Maintained)
2138 -u UPDATE_ATTRIBUTE, --update-project-attribute UPDATE_ATTRIBUTE
2141 Use this attribute to find update projects (default is
2142 OBS:UpdateProject)
2143 --dryrun
2146 Just simulate the action and report back the result.
2147 --noaccess
2150 Create a hidden project
2151 --nodevelproject
2154 do not follow a defined devel project (primary project
2155 where a package is developed)
2156 --version
2159 print version of maintained package
2160 osc meta
2163 Show meta information, or edit it
2164 usage: osc [global opts] meta [-h] [-a ATTRIBUTE] [--attribute-de‐
2166 faults]
2167 [--attribute-project] [--blame] [-f] [-F
2168 FILE]
2169 [-r REV] [-m TEXT] [-e] [-c] [-R]
2170 [-s ATTRIBUTE_VALUES] [--delete]
2171 Show or edit build service metadata of type <prj|pkg|prjconf|user|pat‐
2173 tern>.
2174 This command displays metadata on buildservice objects like projects,
2176 packages, or users. The type of metadata is specified by the word after
2177 "meta", like e.g. "meta prj".
2178 prj denotes metadata of a buildservice project. prjconf denotes the
2180 (build) configuration of a project. pkg denotes metadata of a build‐
2181 service package. user denotes the metadata of a user. group denotes
2182 the metadata of a group. pattern denotes installation patterns defined
2183 for a project.
2184 To list patterns, use 'osc meta pattern PRJ'. An additional argument
2186 will be the pattern file to view or edit.
2187 With the --edit switch, the metadata can be edited. Per default, osc
2189 opens the program specified by the environmental variable EDITOR with a
2190 temporary file. Alternatively, content to be saved can be supplied via
2191 the --file switch. If the argument is '-', input is taken from stdin:
2192 osc meta prjconf home:user | sed ... | osc meta prjconf home:user -F -
2193 For meta prj and prjconf updates optional commit messages can be ap‐
2195 plied with --message.
2196 When trying to edit a non-existing resource, it is created implicitly.
2198 Examples:
2200 osc meta prj PRJ
2201 osc meta pkg PRJ PKG
2202 osc meta pkg PRJ PKG -e
2203 usage:
2205 osc meta <prj|prjconf> [-r|--revision REV] ARGS...
2206 osc meta <prj|pkg|prjconf|user|group|pattern> ARGS...
2207 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message TEXT]
2208 -e|--edit ARGS...
2209 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message TEXT]
2210 -F|--file ARGS...
2211 osc meta pattern --delete PRJ PATTERN
2212 osc meta attribute PRJ [PKG [SUBPACKAGE]] [--attribute ATTRIBUTE]
2213 [--create [--set <value_list>]|--delete|--set <value_list>]
2214 options:
2216 -a ATTRIBUTE, --attribute ATTRIBUTE
2218 affect only a given attribute
2219 --attribute-defaults
2222 include defined attribute defaults
2223 --attribute-project
2226 include project values, if missing in packages
2227 --blame
2230 show author and time of each line
2231 -f, --force
2234 force the save operation, allows one to ignores some er‐
2235 rors like depending repositories. For prj meta only.
2236 -F FILE, --file FILE
2239 read metadata from FILE, instead of opening an editor.
2240 '-' denotes standard input.
2241 -r REV, --revision REV
2244 checkout given revision instead of head revision. For prj
2245 and prjconf meta only
2246 -m TEXT, --message TEXT
2249 specify log message TEXT. For prj and prjconf meta only
2250 -e, --edit
2253 edit metadata
2254 -c, --create
2257 create attribute without values
2258 -R, --remove-linking-repositories
2261 Try to remove also all repositories building against re‐
2262 move ones.
2263 -s ATTRIBUTE_VALUES, --set ATTRIBUTE_VALUES
2266 set attribute values
2267 --delete
2270 delete a pattern or attribute
2271 osc mkpac
2274 Create a new package under version control
2275 usage: osc [global opts] mkpac [-h]
2277 usage:
2279 osc mkpac new_package
2280 osc mv
2282 Move SOURCE file to DEST and keep it under version control
2283 usage: osc [global opts] mv [-h] [-f] source dest
2285 arguments:
2287 source
2289 dest
2292 options:
2295 -f, --force
2297 forces removal of entire package and its files
2298 osc my
2301 Show waiting work, packages, projects or requests involving yourself
2302 usage: osc [global opts] my [-h] [-b] [-m] [-a] [-U USER]
2304 [--exclude-project EXCLUDE_PROJECT]
2305 [--maintained]
2306 Examples:
2308 # list all open tasks for me
2309 osc my [work]
2310 # list packages where I am bugowner
2311 osc my pkg -b
2312 # list projects where I am maintainer
2313 osc my prj -m
2314 # list request for all my projects and packages
2315 osc my rq
2316 # list requests, excluding project 'foo' and 'bar'
2317 osc my rq --exclude-project foo,bar
2318 # list requests I made
2319 osc my sr
2320 usage:
2322 osc my <TYPE>
2323 where TYPE is one of requests, submitrequests,
2325 projects or packages (rq, sr, prj or pkg)
2326 options:
2328 -b, --bugowner
2330 restrict listing to items where the user is bugowner
2331 -m, --maintainer
2334 restrict listing to items where the user is maintainer
2335 -a, --all
2338 all involvements
2339 -U USER, --user USER
2342 search for USER instead of yourself
2343 --exclude-project EXCLUDE_PROJECT
2346 exclude requests for specified project
2347 --maintained
2350 limit search results to packages with maintained attri‐
2351 bute set.
2352 osc patchinfo
2355 Generate and edit a patchinfo file
2356 usage: osc [global opts] patchinfo [-h] [-f]
2358 A patchinfo file describes the packages for an update and the kind of
2360 problem it solves.
2361 This command either creates a new _patchinfo or updates an existing
2363 one.
2364 Examples:
2366 osc patchinfo
2367 osc patchinfo [PROJECT [PATCH_NAME]]
2368 options:
2370 -f, --force
2372 force generation of new patchinfo file, do not update ex‐
2373 isting one.
2374 osc pdiff
2377 Quick alias to diff the content of a package with its parent
2378 usage: osc [global opts] pdiff [-h] [-p] [-n]
2380 usage:
2382 osc pdiff [--plain|-p] [--nomissing-ok|-n]
2383 osc pdiff [--plain|-p] [--nomissing-ok|-n] PKG
2384 osc pdiff [--plain|-p] [--nomissing-ok|-n] PRJ PKG
2385 options:
2387 -p, --plain
2389 output the diff in plain (not unified) diff format
2390 -n, --nomissingok
2393 fail if the parent package does not exist on the server
2394 osc prdiff (projdiff, projectdiff)
2397 Server-side diff of two projects
2398 usage: osc [global opts] prdiff [-h] [-r] [-e REGEXP] [-i REGEXP] [-n]
2400 [-o]
2401 [-u] [-d]
2402 Compares two projects and either summarizes or outputs the differences
2404 in full. In the second form, a project is compared with one of its
2405 branches inside a home:$USER project (the branch is treated as NEWPRJ).
2406 The home branch is optional if the current working directory is a
2407 checked out copy of it.
2408 usage:
2410 osc prdiff [OPTIONS] OLDPRJ NEWPRJ
2411 osc prdiff [OPTIONS] [home:$USER:branch:$PRJ]
2412 options:
2414 -r, --requests
2416 show open requests for any packages with differences
2417 -e REGEXP, --exclude REGEXP
2420 skip packages matching REGEXP
2421 -i REGEXP, --include REGEXP
2424 only consider packages matching REGEXP
2425 -n, --show-not-in-old
2428 show packages only in the new project
2429 -o, --show-not-in-new
2432 show packages only in the old project
2433 -u, --unified
2436 show full unified diffs of differences
2437 -d, --diffstat
2440 show diffstat of differences
2441 osc prjresults (pr)
2444 Shows project-wide build results
2445 usage: osc [global opts] prjresults [-h] [-b] [-w] [-c] [--xml] [-s
2447 STATUS]
2448 [-n EXPR] [-a ARCH] [-r REPO] [-V]
2449 [--show-excluded]
2450 usage:
2452 osc prjresults (inside working copy)
2453 osc prjresults PROJECT
2454 options:
2456 -b, --brief
2458 show the result in "pkgname repo arch result"
2459 -w, --watch
2462 watch the results until all finished building, only sup‐
2463 ported with --xml
2464 -c, --csv
2467 csv output
2468 --xml generate output in XML
2471 -s STATUS, --status-filter STATUS
2474 show only packages with buildstatus STATUS (see legend)
2475 -n EXPR, --name-filter EXPR
2478 show only packages whose names match EXPR
2479 -a ARCH, --arch ARCH
2482 show results only for specified architecture(s)
2483 -r REPO, --repo REPO
2486 show results only for specified repo(s)
2487 -V, --vertical
2490 list packages vertically instead horizontally
2491 --show-excluded
2494 show packages that are excluded in all repos, also hide
2495 repos that have only excluded packages
2496 osc pull
2499 Merge the changes of the link target into your working copy
2500 usage: osc [global opts] pull [-h]
2502 osc rdelete
2504 Delete a project or packages on the server
2505 usage: osc [global opts] rdelete [-h] [-r] [-f] [-m TEXT]
2507 As a safety measure, project must be empty (i.e., you need to delete
2509 all packages first). Also, packages must have no requests pending
2510 (i.e., you need to accept/revoke such requests first). If you are sure
2511 that you want to remove this project and all its packages use '--recur‐
2512 sive' switch. It may still not work because other depends on it. If
2513 you want to ignore this as well use '--force' switch.
2514 usage:
2516 osc rdelete [-r] [-f] PROJECT [PACKAGE]
2517 options:
2519 -r, --recursive
2521 deletes a project with packages inside
2522 -f, --force
2525 deletes a project where other depends on
2526 -m TEXT, --message TEXT
2529 specify log message TEXT
2530 osc rdiff
2533 Server-side "pretty" diff of two packages
2534 usage: osc [global opts] rdiff [-h] [--issues-only] [-M] [-r N[:M]]
2536 [-p]
2537 [-c rev] [--missingok] [-u] [--xml]
2538 Compares two packages (three or four arguments) or shows the changes of
2540 a specified revision of a package (two arguments)
2541 If no revision is specified the latest revision is used.
2543 usage:
2545 osc rdiff OLDPRJ OLDPAC NEWPRJ [NEWPAC]
2546 osc rdiff PROJECT PACKAGE
2547 osc rdiff PROJECT --meta
2548 options:
2550 --issues-only
2552 show only issues in diff
2553 -M, --meta
2556 diff meta data
2557 -r N[:M], --revision N[:M]
2560 revision id, where N = old revision and M = new revision
2561 -p, --plain
2564 output the diff in plain (not unified) diff format and
2565 show diff of files in archives
2566 -c rev, --change rev
2569 the change made by revision rev (like -r rev-1:rev). If
2570 rev is negative this is like -r rev:rev-1.
2571 --missingok
2574 do not fail if the source or target project/package does
2575 not exist on the server
2576 -u, --unexpand
2579 diff unexpanded version if sources are linked
2580 --xml show diff as xml (only for issues diff)
2583 osc rebuild (rebuildpac)
2586 Trigger package rebuilds
2587 usage: osc [global opts] rebuild [-h] [-a ARCH] [-r REPO] [-f] [-M FLA‐
2589 VOR]
2590 [--all]
2591 Note that it is normally NOT needed to kick off rebuilds like this, be‐
2593 cause they principally happen in a fully automatic way, triggered by
2594 source check-ins. In particular, the order in which packages are built
2595 is handled by the build service.
2596 The arguments REPOSITORY and ARCH can be taken from the first two col‐
2598 umns of the 'osc repos' output.
2599 usage:
2601 osc rebuild [PROJECT [PACKAGE[:FLAVOR] [REPOSITORY [ARCH]]]]
2602 options:
2604 -a ARCH, --arch ARCH
2606 trigger rebuilds for a specific architecture
2607 -r REPO, --repo REPO
2610 trigger rebuilds for a specific repository
2611 -f, --failed
2614 rebuild all failed packages
2615 -M FLAVOR, --multibuild-package FLAVOR
2618 Only work with the specified flavors of a multibuild
2619 package. Globs are resolved according to _multibuild
2620 file from server. Empty string is resolved to a package
2621 without a flavor.
2622 --all Rebuild all packages of entire project
2625 osc release
2628 Release sources and binaries
2629 usage: osc [global opts] release [-h] [-r REPO]
2631 [--target-project TARGETPROJECT]
2632 [--target-repository TARGETREPOSITORY]
2633 [--set-release RELEASETAG] [--no-de‐
2634 lay]
2635 This command is used to transfer sources and binaries without rebuild‐
2637 ing them. It requires defined release targets set to trigger="manual".
2638 usage:
2640 osc release [PROJECT [PACKAGE]]
2641 options:
2643 -r REPO, --repo REPO
2645 Release only binaries from the specified repository
2646 --target-project TARGETPROJECT
2649 Release only to specified project
2650 --target-repository TARGETREPOSITORY
2653 Release only to specified repository
2654 --set-release RELEASETAG
2657 rename binaries during release using this release tag
2658 --no-delay
2661 Don't put the release job in a queue to be run later, but
2662 immediately run it. Thus the next call to osc prjresult
2663 will reflect it. Otherwise there is no way to know if it
2664 is finished or didn't start yet.
2665 osc releaserequest
2668 Create a release request
2669 usage: osc [global opts] releaserequest [-h] [-m TEXT] [-p PKG]
2671 For maintenance incident projects:
2673 This command is used by the maintenance team to start the release
2675 process of a maintenance update. This includes usually testing based
2676 on the defined reviewers of the update project.
2677 [See https://openbuildservice.org/help/manu‐
2679 als/obs-user-guide/cha.obs.maintenance_setup.html
2680 for information on this topic.]
2681 For normal projects:
2683 This command is used to transfer sources and binaries without rebuild‐
2685 ing them. It requires defined release targets set to trigger="manual".
2686 [See https://openbuildservice.org/help/manu‐
2688 als/obs-user-guide/cha.obs.request_and_review_system.html
2689 for information on this topic.]
2690 usage:
2692 osc releaserequest [-p package] [ SOURCEPROJECT ]
2693 options:
2695 -m TEXT, --message TEXT
2697 specify message TEXT
2698 -p PKG, --package PKG
2701 specify packages to release
2702 osc remotebuildlog (remotebuildlogtail, rbuildlogtail, rblt, rbuildlog,
2705 rbl)
2706 Shows the build log of a package
2707 usage: osc [global opts] remotebuildlog [-h] [-l] [--lastsucceeded]
2709 [-M FLAVOR] [-o OFFSET] [-s]
2710 Shows the log file of the build of a package. Can be used to follow the
2712 log while it is being written.
2713 remotebuildlogtail shows just the tail of the log file.
2715 usage:
2717 osc remotebuildlog project package[:flavor] repository arch
2718 or
2719 osc remotebuildlog project/package[:flavor]/repository/arch
2720 or
2721 osc remotebuildlog buildlogurl
2722 options:
2724 -l, --last
2726 Show the last finished log file
2727 --lastsucceeded, --last-succeeded
2730 Show the last succeeded log file
2731 -M FLAVOR, --multibuild-package FLAVOR
2734 Only work with the specified flavor of a multibuild pack‐
2735 age.
2736 -o OFFSET, --offset OFFSET
2739 get log starting or ending from the offset
2740 -s, --strip-time
2743 strip leading build time from the log
2744 osc repairlink
2747 Repair a broken source link
2748 usage: osc [global opts] repairlink [-h] [-d DIR]
2750 This command checks out a package with merged source changes. It uses a
2752 3-way merge to resolve file conflicts. After reviewing/repairing the
2753 merge, use 'osc resolved ...' and 'osc ci' to re-create a working
2754 source link.
2755 usage: * For merging conflicting changes of a checkout package:
2757 osc repairlink
2758 * Check out a package and merge changes:
2760 osc repairlink PROJECT PACKAGE
2761 * Pull conflicting changes from one project into another one:
2763 osc repairlink PROJECT PACKAGE INTO_PROJECT [INTO_PACKAGE]
2764 options:
2766 -d DIR, --destdir DIR
2768 destination directory
2769 osc repairwc
2772 Try to repair an inconsistent working copy
2773 usage: osc [global opts] repairwc [-h] [--force-apiurl]
2775 Examples:
2777 osc repairwc <path>
2778 Note: if <path> is omitted it defaults to '.' (<path> can be a project
2780 or package working copy)
2781 Warning: This command might delete some files in the storedir (.osc).
2783 Please check the state of the wc afterwards (via 'osc status').
2784 options:
2786 --force-apiurl
2788 ask once for an apiurl and force this apiurl for all in‐
2789 consistent projects/packages
2790 osc repositories (platforms, repos)
2793 Shows repositories configured for a project
2794 usage: osc [global opts] repositories [-h]
2796 It skips repositories by default which are disabled for a given pack‐
2798 age.
2799 usage:
2801 osc repos
2802 osc repos [PROJECT] [PACKAGE]
2803 osc repourls
2805 Shows URLs of .repo files
2806 usage: osc [global opts] repourls [-h]
2808 Shows URLs on which to access the project repositories.
2810 usage:
2812 osc repourls [PROJECT]
2813 osc request (review, rq)
2815 Show or modify requests and reviews
2816 usage: osc [global opts] request [-h] [-d] [-S SUPERSEDED_REQUEST] [-u]
2818 [--no-devel] [-m TEXT] [-t TYPE] [-a]
2819 [-f]
2820 [-s STATE] [-D DAYS] [-U USER] [-G
2821 GROUP]
2822 [-P PROJECT] [-p PACKAGE] [-b] [-M]
2823 [-B] [-e]
2824 [-i] [--or-revoke] [--non-interactive]
2825 [--exclude-target-project EXCLUDE_TAR‐
2826 GET_PROJECT]
2827 [--incoming] [--involved-projects]
2828 [--target-package-filter TARGET_PACK‐
2829 AGE_FILTER]
2830 [--source-buildstatus]
2831 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
2833 information on this topic.]
2834 The 'request' command has the following sub commands:
2836 "list" lists open requests attached to a project or package or person.
2838 Uses the project/package of the current directory if none of -M, -U
2839 USER, project/package are given.
2840 "log" will show the history of the given ID
2842 "show" will show the request itself, and generate a diff for review, if
2844 used with the --diff option. The keyword show can be omitted if the ID
2845 is numeric.
2846 "decline" will change the request state to "declined"
2848 "reopen" will set the request back to new or review.
2850 "setincident" will direct "maintenance" requests into specific inci‐
2852 dents
2853 "supersede" will supersede one request with another existing one.
2855 "revoke" will set the request state to "revoked"
2857 "accept" will change the request state to "accepted" and will trigger
2859 the actual submit process. That would normally be a server-side copy of
2860 the source package to the target package.
2861 "approve" marks a requests in "review" state as approved. This request
2863 will get accepted automatically when the last review got accepted.
2864 "checkout" will checkout the request's source package ("submit" re‐
2866 quests only).
2867 "prioritize" change the priority of a request to either "critical",
2869 "important", "moderate" or "low"
2870 The 'review' command has the following sub commands:
2873 "list" lists open requests that need to be reviewed by the specified
2875 user or group
2876 "add" adds a person or group as reviewer to a request
2878 "accept" mark the review positive
2880 "decline" mark the review negative. A negative review will decline the
2882 request.
2883 usage:
2885 osc request list [-M] [-U USER] [-s state] [-D DAYS] [-t type] [-B]
2886 [PRJ [PKG]]
2887 osc request log ID
2888 osc request [show] [-d] [-b] ID
2889 osc request accept [-m TEXT] ID
2891 osc request approve [-m TEXT] ID
2892 osc request cancelapproval [-m TEXT] ID
2893 osc request decline [-m TEXT] ID
2894 osc request revoke [-m TEXT] ID
2895 osc request reopen [-m TEXT] ID
2896 osc request setincident [-m TEXT] ID INCIDENT
2897 osc request supersede [-m TEXT] ID SUPERSEDING_ID
2898 osc request approvenew [-m TEXT] PROJECT
2899 osc request prioritize [-m TEXT] ID PRIORITY
2900 osc request checkout/co ID
2902 osc request clone [-m TEXT] ID
2903 osc review show [-d] [-b] ID
2905 osc review list [-U USER] [-G GROUP] [-P PROJECT [-p PACKAGE]] [-s
2906 state]
2907 osc review add [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p PACK‐
2908 AGE]] ID
2909 osc review accept [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
2910 PACKAGE]] ID
2911 osc review decline [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
2912 PACKAGE]] ID
2913 osc review reopen [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
2914 PACKAGE]] ID
2915 osc review supersede [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
2916 PACKAGE]] ID SUPERSEDING_ID
2917 options:
2919 -d, --diff
2921 generate a diff
2922 -S SUPERSEDED_REQUEST, --superseded-request SUPERSEDED_REQUEST
2925 Create the diff relative to a given former request
2926 -u, --unified
2929 output the diff in the unified diff format
2930 --no-devel
2933 Do not attempt to forward to devel project
2934 -m TEXT, --message TEXT
2937 specify message TEXT
2938 -t TYPE, --type TYPE
2941 limit to requests which contain a given action type (sub‐
2942 mit/delete/change_devel/add_role/set_bugowner/mainte‐
2943 nance_incident/maintenance_release)
2944 -a, --all
2947 all states. Same as'-s all'
2948 -f, --force
2951 enforce state change, can be used to ignore open reviews
2952 -s STATE, --state STATE
2955 only list requests in one of the comma separated given
2956 states (new/review/accepted/revoked/declined) or "all"
2957 [default="new,review"]
2958 -D DAYS, --days DAYS
2961 only list requests in state "new" or changed in the last
2962 DAYS.
2963 -U USER, --user USER
2966 requests or reviews limited for the specified USER
2967 -G GROUP, --group GROUP
2970 requests or reviews limited for the specified GROUP
2971 -P PROJECT, --project PROJECT
2974 requests or reviews limited for the specified PROJECT
2975 -p PACKAGE, --package PACKAGE
2978 requests or reviews limited for the specified PACKAGE,
2979 requires also a PROJECT
2980 -b, --brief
2983 print output in list view as list subcommand
2984 -M, --mine
2987 only show requests created by yourself
2988 -B, --bugowner
2991 also show requests about packages where I am bugowner
2992 -e, --edit
2995 edit a submit action
2996 -i, --interactive
2999 interactive review of request
3000 --or-revoke
3003 For automation scripts: accepts (if using with accept ar‐
3004 gument) a request when it is in new or review state. Or
3005 revoke it when it got declined. Otherwise just do noth‐
3006 ing.
3007 --non-interactive
3010 non-interactive review of request
3011 --exclude-target-project EXCLUDE_TARGET_PROJECT
3014 exclude target project from request list
3015 --incoming
3018 Show only requests where the project is target
3019 --involved-projects
3022 show all requests for project/packages where USER is in‐
3023 volved
3024 --target-package-filter TARGET_PACKAGE_FILTER
3027 only list requests for the packages matching the package
3028 filter. A (python) regular expression is expected.
3029 --source-buildstatus
3032 print the buildstatus of the source package (only works
3033 with "show" and the interactive review)
3034 osc requestmaintainership (reqbs, reqms, reqmaintainership, requestbugown‐
3037 ership, reqbugownership)
3038 Requests to add user as maintainer or bugowner
3039 usage: osc [global opts] requestmaintainership [-h] [-m TEXT] [-r role]
3041 usage:
3043 osc requestmaintainership # for current
3044 user in checked out package
3045 osc requestmaintainership USER # for speci‐
3046 fied user in checked out package
3047 osc requestmaintainership PROJECT # for current
3048 user if cwd is not a checked out package
3049 osc requestmaintainership PROJECT group:NAME # request for
3050 specified group
3051 osc requestmaintainership PROJECT PACKAGE # for current
3052 user
3053 osc requestmaintainership PROJECT PACKAGE USER # request for
3054 specified user
3055 osc requestmaintainership PROJECT PACKAGE group:NAME # request for
3056 specified group
3057 osc requestbugownership ... # accepts same
3059 parameters but uses bugowner role
3060 options:
3062 -m TEXT, --message TEXT
3064 specify message TEXT
3065 -r role, --role role
3068 specify user role (default: maintainer)
3069 osc resolved
3072 Remove 'conflicted' state on working copy files
3073 usage: osc [global opts] resolved [-h]
3075 If an upstream change can't be merged automatically, a file is put into
3077 in 'conflicted' ('C') state. Within the file, conflicts are marked with
3078 special <<<<<<< as well as ======== and >>>>>>> lines.
3079 After manually resolving all conflicting parts, use this command to re‐
3081 move the 'conflicted' state.
3082 Note: this subcommand does not semantically resolve conflicts or re‐
3084 move conflict markers; it merely removes the conflict-related artifact
3085 files and allows PATH to be committed again.
3086 usage:
3088 osc resolved FILE [FILE...]
3089 osc restartbuild (abortbuild)
3091 Restart the build of a certain project or package
3092 usage: osc [global opts] restartbuild [-h] [-a ARCH] [-M FLAVOR] [-r
3094 REPO]
3095 [--all]
3096 usage:
3098 osc restartbuild [PROJECT [PACKAGE[:FLAVOR] [REPOSITORY [ARCH]]]]
3099 options:
3101 -a ARCH, --arch ARCH
3103 Restart builds for a specific architecture
3104 -M FLAVOR, --multibuild-package FLAVOR
3107 Only work with the specified flavors of a multibuild
3108 package. Globs are resolved according to _multibuild
3109 file from server. Empty string is resolved to a package
3110 without a flavor.
3111 -r REPO, --repo REPO
3114 Restart builds for a specific repository
3115 --all Restart all running builds of entire project
3118 osc results (r)
3121 Shows the build results of a package or project
3122 usage: osc [global opts] results [-h] [-l] [-r REPO] [-a ARCH] [-b]
3124 [--no-multibuild] [-M FLAVOR] [-V]
3125 [-w]
3126 [-s STATUS_FILTER] [-f] [--xml]
3127 [--csv]
3128 [--format FORMAT] [--show-excluded]
3129 usage:
3131 osc results # (inside working copy of PRJ or PKG)
3132 osc results PROJECT [PACKAGE[:FLAVOR]]
3133 options:
3135 -l, --last-build
3137 show last build results (succeeded/failed/unknown)
3138 -r REPO, --repo REPO
3141 Show results only for specified repo(s)
3142 -a ARCH, --arch ARCH
3145 Show results only for specified architecture(s)
3146 -b, --brief
3149 show the result in "pkgname repo arch result". Default
3150 for -f
3151 --no-multibuild
3154 Disable results for all direct affect packages inside of
3155 the project
3156 -M FLAVOR, --multibuild-package FLAVOR
3159 Only work with the specified flavors of a multibuild
3160 package. Globs are resolved according to _multibuild
3161 file from server. Empty string is resolved to a package
3162 without a flavor.
3163 -V, --vertical
3166 list packages vertically instead horizontally for entire
3167 project
3168 -w, --watch
3171 watch the results until all finished building
3172 -s STATUS_FILTER, --status-filter STATUS_FILTER
3175 only show packages with the given build status
3176 -f, --failed
3179 show only failed results
3180 --xml generate output in XML (former results_meta)
3183 --csv generate output in CSV format
3186 --format FORMAT
3189 format string for csv output
3190 --show-excluded
3193 show repos that are excluded for this package
3194 osc revert
3197 Restore changed files or the entire working copy
3198 usage: osc [global opts] revert [-h] file [file ...]
3200 Examples:
3202 osc revert <modified file(s)>
3203 osc revert . Note: this only works for package working copies
3204 arguments:
3206 file
3208 osc rpmlintlog (lint, rpmlint)
3211 Shows the rpmlint logfile
3212 usage: osc [global opts] rpmlintlog [-h]
3214 Shows the rpmlint logfile to analyse if there are any problems with the
3216 spec file and the built binaries.
3217 usage:
3219 osc rpmlintlog project package repository arch
3220 osc rremove
3222 Remove source files from selected package
3223 usage: osc [global opts] rremove [-h] [-f] project package file [file
3225 ...]
3226 arguments:
3228 project
3230 package
3233 file
3236 options:
3239 -f, --force
3241 Don't ask and delete files
3242 osc search (bse, se)
3245 Search for a project and/or package
3246 usage: osc [global opts] search [-h] [--repos-baseurl] [-e] [-s]
3248 [--package]
3249 [--project] [--title] [--description]
3250 [-a ATTRIBUTE] [-V] [-i] [-b] [-m] [-M]
3251 [--csv] [--binary] [-B PROJECT]
3252 [--binaryversion VERSION]
3253 If no option is specified osc will search for projects and packages
3255 which contains the 'search term' in their name, title or description.
3256 usage:
3258 osc search 'search term' <options>
3259 osc bse ... ('osc search --binary')
3260 osc se 'perl(Foo::Bar)' ('osc search --package
3261 perl-Foo-Bar')
3262 options:
3264 --repos-baseurl
3266 show base URLs of download repositories
3267 -e, --exact
3270 show only exact matches, this is default now
3271 -s, --substring
3274 Show also results where the search term is a sub string,
3275 slower search
3276 --package
3279 search for a package
3280 --project
3283 search for a project
3284 --title
3287 search for matches in the 'title' element
3288 --description
3291 search for matches in the 'description' element
3292 -a ATTRIBUTE, --limit-to-attribute ATTRIBUTE
3295 match only when given attribute exists in meta data
3296 -V, --version
3299 show package version, revision, and srcmd5. CAUTION: This
3300 is slow and unreliable
3301 -i, --involved
3304 show projects/packages where given person (or myself) is
3305 involved as bugowner or maintainer [[{group|per‐
3306 son}/]<name>] default: person
3307 -b, --bugowner
3310 as -i, but only bugowner
3311 -m, --maintainer
3314 as -i, but only maintainer
3315 -M, --mine
3318 shorthand for --bugowner --package
3319 --csv generate output in CSV (separated by |)
3322 --binary
3325 search binary packages
3326 -B PROJECT, --baseproject PROJECT
3329 search packages built for PROJECT (implies --binary)
3330 --binaryversion VERSION
3333 search for binary with specified version (implies --bi‐
3334 nary)
3335 osc sendsysrq
3338 Trigger a sysrq in a running build
3339 usage: osc [global opts] sendsysrq [-h] [-M FLAVOR]
3341 This is only going to work when the build is running in a supported VM.
3343 Also only a subset of sysrq are supported. Typical use case for debug‐
3344 ging are 9, t and w in this sequence.
3345 usage:
3347 osc sendsysrq REPOSITORY ARCH SYSRQ
3348 osc sendsysrq PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH SYSRQ
3349 options:
3351 -M FLAVOR, --multibuild-package FLAVOR
3353 Only work with the specified flavors of a multibuild
3354 package. Globs are resolved according to _multibuild
3355 file from server. Empty string is resolved to a package
3356 without a flavor.
3357 osc service
3360 Handle source services
3361 usage: osc [global opts] service [-h] [-v]
3363 Source services can be used to modify sources like downloading files,
3365 verify files, generating files or modify existing files.
3366 usage:
3368 osc service COMMAND (inside working copy)
3369 osc service run [SOURCE_SERVICE]
3370 osc service runall
3371 osc service manualrun [SOURCE_SERVICE]
3372 osc service localrun [SOURCE_SERVICE]
3373 osc service disabledrun [SOURCE_SERVICE]
3374 osc service remoterun [PROJECT PACKAGE]
3375 osc service merge [PROJECT PACKAGE]
3376 osc service wait [PROJECT PACKAGE]
3377 COMMAND can be:
3379 run r run defined services with modes "trylocal",
3380 "localonly", or no mode set locally,
3381 may take an optional parameter to run only a speci‐
3382 fied source service. In case
3383 parameters exist for this one in _service file they
3384 are used.
3385 runall ra run all services independent of the used mode
3386 manualrun mr run all services with mode "manual", may take an op‐
3387 tional parameter to run only a
3388 specified source service
3389 remoterun rr trigger a re-run on the server side
3390 merge commits all server side generated files and drops
3391 the _service definition
3392 wait waits until the service finishes and returns with an
3393 error if it failed
3394 Not for common usage anymore:
3396 localrun lr the same as "run" but services with mode
3397 "serveronly" are also executed
3398 disabledrun dr run all services with mode "disabled"
3399 options:
3401 -v, --verbose
3403 verbose run of local services for debugging purposes
3404 osc setdevelproject (sdp)
3407 Set the devel project / package of a package
3408 usage: osc [global opts] setdevelproject [-h] [-u]
3410 Examples:
3412 osc setdevelproject [PROJECT PACKAGE] DEVEL_PROJECT [DEVEL_PACKAGE]
3413 options:
3415 -u, --unset
3417 remove devel project
3418 osc setlinkrev
3421 Updates a revision number in a source link
3422 usage: osc [global opts] setlinkrev [-h] [-r rev] [-R] [-u]
3424 This command adds or updates a specified revision number in a source
3426 link. The current revision of the source is used, if no revision num‐
3427 ber is specified.
3428 usage:
3430 osc setlinkrev
3431 osc setlinkrev PROJECT [PACKAGE]
3432 options:
3434 -r rev, --revision rev
3436 use the specified revision.
3437 -R, --use-plain-revision
3440 Do not expand revision the specified or latest rev
3441 -u, --unset
3444 remove revision in link, it will point always to latest
3445 revision
3446 osc showlinked
3449 Show all packages linking to a given one
3450 usage: osc [global opts] showlinked [-h]
3452 Examples:
3454 osc showlinked [PROJECT PACKAGE]
3455 osc signkey
3457 Manage Project Signing Key
3458 usage: osc [global opts] signkey [-h] [--create] [--extend] [--delete]
3460 [--notraverse] [--sslcert]
3461 osc signkey [--create|--delete|--extend] <PROJECT> osc signkey [--no‐
3463 traverse] <PROJECT>
3464 This command is for managing gpg keys. It shows the public key by de‐
3466 fault. There is no way to download or upload the private part of a key
3467 by design.
3468 However you can create a new own key. You may want to consider to sign
3470 the public key with your own existing key.
3471 If a project has no key, the key from upper level project will be used
3473 (e.g. when dropping "KDE:KDE4:Community" key, the one from "KDE:KDE4"
3474 will be used).
3475 WARNING: THE OLD KEY CANNOT BE RESTORED AFTER USING DELETE OR CREATE
3477 options:
3479 --create
3481 create new gpg signing key for this project
3482 --extend
3485 extend expiration date of the gpg public key for this
3486 project
3487 --delete
3490 delete the gpg signing key in this project
3491 --notraverse
3494 don't traverse projects upwards to find key
3495 --sslcert
3498 fetch SSL certificate instead of GPG key
3499 osc status (st)
3502 Show status of files in working copy
3503 usage: osc [global opts] status [-h] [-e]
3505 Show the status of files in a local working copy, indicating whether
3507 files have been changed locally, deleted, added, ...
3508 The first column in the output specifies the status and is one of the
3510 following characters:
3511 ' ' no modifications
3512 'A' Added
3513 'C' Conflicted
3514 'D' Deleted
3515 'M' Modified
3516 'R' Replaced (file was deleted and added again afterwards)
3517 '?' item is not under version control
3518 '!' item is missing (removed by non-osc command) or incomplete
3519 'S' item is skipped (item exceeds a file size limit or is _service:*
3520 file)
3521 'F' Frozen (use "osc pull" to merge conflicts) (package-only state)
3522 examples:
3524 osc st
3525 osc st <directory>
3526 osc st file1 file2 ...
3527 usage:
3529 osc status [OPTS] [PATH...]
3530 options:
3532 -e, --show-excluded
3534 also show files which are excluded by the "exclude_glob"
3535 config option
3536 osc submitrequest (submitpac, submitreq, sr)
3539 Create request to submit source into another Project
3540 usage: osc [global opts] submitrequest [-h] [-m TEXT] [-F FILE] [-r
3542 REV]
3543 [-s REQUEST_ID] [--nodevelpro‐
3544 ject]
3545 [--separate-requests]
3546 [--cleanup]
3547 [--no-cleanup] [--no-update]
3548 [--update-link] [-d] [--yes]
3549 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
3551 information on this topic.]
3552 See the "request" command for showing and modifying existing requests.
3554 usage:
3556 osc submitreq [OPTIONS]
3557 osc submitreq [OPTIONS] DESTPRJ [DESTPKG]
3558 osc submitreq [OPTIONS] SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
3559 osc submitpac ... is a shorthand for osc submitreq --cleanup ...
3561 options:
3563 -m TEXT, --message TEXT
3565 specify message TEXT
3566 -F FILE, --file FILE
3569 read log message from FILE, '-' denotes standard input.
3570 -r REV, --revision REV
3573 specify a certain source revision ID (the md5 sum) for
3574 the source package
3575 -s REQUEST_ID, --supersede REQUEST_ID
3578 Superseding another request by this one
3579 --nodevelproject
3582 do not follow a defined devel project (primary project
3583 where a package is developed)
3584 --separate-requests
3587 Create multiple requests instead of a single one (when
3588 command is used for entire project)
3589 --cleanup
3592 remove package if submission gets accepted (default for
3593 home:<id>:branch projects)
3594 --no-cleanup
3597 never remove source package on accept, but update its
3598 content
3599 --no-update
3602 never touch source package on accept (will break source
3603 links)
3604 --update-link
3607 This transfers the source including the _link file.
3608 -d, --diff
3611 show diff only instead of creating the actual request
3612 --yes proceed without asking.
3615 osc token
3618 Show and manage authentication token
3619 usage: osc [global opts] token [-h] [-c] [-d TOKENID] [-o OPERATION]
3621 [-t TOKENSTRING] [--scm-token SCM_TOKEN]
3622 Authentication token can be used to run specific commands without send‐
3624 ing credentials.
3625 usage:
3627 osc token
3628 osc token --create [--operation <OPERATION>] [<PROJECT> <PACKAGE>]
3629 osc token --delete <TOKENID>
3630 osc token --trigger <TOKENSTRING> [--operation <OPERATION>]
3631 [<PROJECT> <PACKAGE>]
3632 options:
3634 -c, --create
3636 Create a new token
3637 -d TOKENID, --delete TOKENID
3640 Delete a token
3641 -o OPERATION, --operation OPERATION
3644 Default is "runservice", but "branch", "release", "re‐
3645 build", or "workflow" can also be used
3646 -t TOKENSTRING, --trigger TOKENSTRING
3649 Trigger the action of a token
3650 --scm-token SCM_TOKEN
3653 The scm's access token (only in combination with a --op‐
3654 eration=workflow option)
3655 osc triggerreason (tr)
3658 Show reason why a package got triggered to build
3659 usage: osc [global opts] triggerreason [-h] [-M FLAVOR]
3661 The server decides when a package needs to get rebuild, this command
3663 shows the detailed reason for a package. A brief reason is also stored
3664 in the jobhistory, which can be accessed via "osc jobhistory".
3665 Trigger reasons might be:
3667 - new build (never build yet or rebuild manually forced)
3668 - source change (e.g. on updating sources)
3669 - meta change (packages which are used for building have changed)
3670 - rebuild count sync (In case that it is configured to sync release
3671 numbers)
3672 usage in package or project directory:
3674 osc triggerreason REPOSITORY ARCH
3675 osc triggerreason PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH
3676 options:
3678 -M FLAVOR, --multibuild-package FLAVOR
3680 Only work with the specified flavor of a multibuild pack‐
3681 age.
3682 osc undelete
3685 Restores a deleted project or package on the server
3686 usage: osc [global opts] undelete [-h] [-m TEXT]
3688 The server restores a package including the sources and meta configura‐
3690 tion. Binaries remain to be lost and will be rebuild.
3691 usage:
3693 osc undelete PROJECT
3694 osc undelete PROJECT PACKAGE
3695 options:
3697 -m TEXT, --message TEXT
3699 specify log message TEXT
3700 osc unlock
3703 Unlocks a project or package
3704 usage: osc [global opts] unlock [-h] [-m TEXT]
3706 Unlocks a locked project or package. A comment is required.
3708 usage:
3710 osc unlock PROJECT [PACKAGE]
3711 options:
3713 -m TEXT, --message TEXT
3715 specify log message TEXT
3716 osc update (up)
3719 Update a working copy
3720 usage: osc [global opts] update [-h] [-r REV] [--linkrev REV] [-u] [-e]
3722 [-s]
3723 [-S] [-l limit_size]
3724 examples:
3726 1. osc up
3728 If the current working directory is a package, update it.
3729 If the directory is a project directory, update all contained
3730 packages, AND check out newly added packages.
3731 To update only checked out packages, without checking out new
3733 ones, you might want to use "osc up *" from within the project
3734 dir.
3735 2. osc up PAC
3737 Update the packages specified by the path argument(s)
3738 When --expand-link is used with source link packages, the expanded
3740 sources will be checked out. Without this option, the _link file and
3741 patches will be checked out. The option --unexpand-link can be used to
3742 switch back to the "raw" source with a _link file plus patch(es).
3743 options:
3745 -r REV, --revision REV
3747 update to specified revision (this option will be ignored
3748 if you are going to update the complete project or more
3749 than one package)
3750 --linkrev REV
3753 revision of the link target that is used during link ex‐
3754 pansion
3755 -u, --unexpand-link
3758 if a package is an expanded link, update to the raw _link
3759 file
3760 -e, --expand-link
3763 if a package is a link, update to the expanded sources
3764 -s, --source-service-files
3767 Run local source services after update.
3768 -S, --server-side-source-service-files
3771 Use server side generated sources instead of local gener‐
3772 ation.
3773 -l limit_size, --limit-size limit_size
3776 Skip all files with a given size
3777 osc updatepacmetafromspec (updatepkgmetafromspec, metafromspec)
3780 Update package meta information from a specfile
3781 usage: osc [global opts] updatepacmetafromspec [-h] [--specfile FILE]
3783 ARG, if specified, is a package working copy.
3785 options:
3787 --specfile FILE
3789 Path to specfile. (if you pass more than working copy
3790 this option is ignored)
3791 osc vc
3794 Edit the changes file
3795 usage: osc [global opts] vc [-h] [-m MESSAGE] [-F FILE] [-e]
3797 osc vc [-m MESSAGE|-e] [filename[.changes]|path [file_with_comment]] If
3799 no <filename> is given, exactly one *.changes or *.spec file has to be
3800 in the cwd or in path.
3801 The email address used in .changes file is read from BuildService in‐
3803 stance, or should be defined in oscrc [https://api.opensuse.org/] user
3804 = login pass = password email = user@defined.email
3805 or can be specified via mailaddr environment variable.
3807 By default, osc vc opens the program specified by the EDITOR environ‐
3809 ment variable (and it uses Vim if that variable is not set) with a tem‐
3810 porary file that should replace the *.changes file when saved by the
3811 editor, or discarded otherwise.
3812 options:
3814 -m MESSAGE, --message MESSAGE
3816 add MESSAGE to changes (do not open an editor)
3817 -F FILE, --file FILE
3820 read changes message from FILE (do not open an editor)
3821 -e, --just-edit
3824 just open changes (cannot be used with -m)
3825 osc version
3828 Give version of osc binary
3829 usage: osc [global opts] version [-h]
3831 usage:
3833 osc version
3834 osc whatdependson
3836 Show the packages that require the specified package during the build
3837 usage: osc [global opts] whatdependson [-h]
3839 The command whatdependson can be used to find out what will be trig‐
3841 gered when a certain package changes.
3842 This is no guarantee, since the new build might have changed dependen‐
3844 cies.
3845 The arguments REPOSITORY and ARCH can be taken from the first two col‐
3847 umns of the 'osc repos' output.
3848 usage in package or project directory:
3850 osc whatdependson REPOSITORY ARCH
3851 usage:
3853 osc whatdependson PROJECT [PACKAGE] REPOSITORY ARCH
3854 osc whois (user, who)
3856 Show fullname and email of a buildservice user
3857 usage: osc [global opts] whois [-h] [user ...]
3859 arguments:
3861 user
3863 osc wipebinaries (unpublish)
3866 Delete all binary packages of a certain project/package
3867 usage: osc [global opts] wipebinaries [-h] [-a ARCH] [-M FLAVOR] [-r
3869 REPO]
3870 [--build-disabled]
3871 [--build-failed]
3872 [--broken] [--unresolvable]
3873 [--all]
3874 With the optional argument <package> you can specify a certain package
3876 otherwise all binary packages in the project will be deleted.
3877 usage:
3879 osc wipebinaries OPTS # works in checked out
3880 project dir
3881 osc wipebinaries OPTS PROJECT [PACKAGE[:FLAVOR]]
3882 osc unpublish OPTS # works in checked out
3883 project dir
3884 osc unpublish OPTS PROJECT [PACKAGE[:FLAVOR]]
3885 options:
3887 -a ARCH, --arch ARCH
3889 Delete all binary packages for a specific architecture
3890 -M FLAVOR, --multibuild-package FLAVOR
3893 Only work with the specified flavors of a multibuild
3894 package. Globs are resolved according to _multibuild
3895 file from server. Empty string is resolved to a package
3896 without a flavor.
3897 -r REPO, --repo REPO
3900 Delete all binary packages for a specific repository
3901 --build-disabled
3904 Delete all binaries of packages for which the build is
3905 disabled
3906 --build-failed
3909 Delete all binaries of packages for which the build
3910 failed
3911 --broken
3914 Delete all binaries of packages for which the package
3915 source is bad
3916 --unresolvable
3919 Delete all binaries of packages which have dependency er‐
3920 rors
3921 --all Delete all binaries regardless of the package status
3924 (previously default)
3925 osc workerinfo
3928 Gets the information to a worker from the server
3929 usage: osc [global opts] workerinfo [-h] <hostarch>:<workerid>
3931 Examples:
3933 osc workerinfo x86_64:goat:1
3934 usage:
3936 osc workerinfo <hostarch>:<workerid>
3937 arguments:
3939 <hostarch>:<workerid>
3941
3945 Contributors to the osc project. See the project's GIT history for the complete list.
3946
3949 The latest version of osc may be downloaded from
3950 ⟨https://github.com/openSUSE/osc/⟩
3951osc 2023-01-17 OSC(1)