1OSC(1) Generated Python Manual OSC(1)
2
6 osc - OpenSUSE Commander
7
9 osc [global opts] <command> [--help] [opts] [args]
10
13 -v, --verbose
14 increase verbosity
15 -q, --quiet
18 be quiet, not verbose
19 --debug
22 print info useful for debugging
23 --debugger
26 jump into the debugger before executing anything
27 --post-mortem
30 jump into the debugger in case of errors
31 --traceback
34 print call trace in case of errors
35 -H, --http-debug
38 debug HTTP traffic (filters some headers)
39 --http-full-debug
42 debug HTTP traffic (filters no headers)
43 -A URL, --apiurl URL
46 Open Build Service API URL or a configured alias
47 --config FILE
50 specify alternate configuration file
51 --setopt KEY=VALUE
54 set a config option for the current program run
55 --no-keyring
58 disable usage of desktop keyring system
59
62 osc repo
63 Manage repositories in project meta
64 usage: osc [global opts] repo [-h] {add,list,ls,remove,rm} ...
66 osc repo add
69 Add a repository to project meta
70 usage: osc [global opts] add [-h] --repo NAME --arch [ARCH] --path
72 [PROJECT/REPO] [--disable-publish] [--yes]
73 project
74 arguments:
76 project
78 Name of the project
79 options:
82 --repo NAME
84 Name of the repository we're adding
85 --arch [ARCH]
88 Architecture of the repository. Can be specified multiple
89 times.
90 --path [PROJECT/REPO]
93 Path associated to the repository. Format is
94 PROJECT/REPO. Can be specified multiple times.
95 --disable-publish
98 Disable publishing the added repository
99 --yes Proceed without asking
102 osc repo list (ls)
105 List repositories in project meta
106 usage: osc [global opts] list [-h] project
108 arguments:
110 project
112 Name of the project
113 osc repo remove (rm)
116 Remove repositories from project meta
117 usage: osc [global opts] remove [-h] --repo [NAME] [--yes] project
119 arguments:
121 project
123 Name of the project
124 options:
127 --repo [NAME]
129 Name of the repository we're removing. Can be specified
130 multiple times.
131 --yes Proceed without asking
134 osc add
137 Mark files to be added upon the next commit
138 usage: osc [global opts] add [-h] [-f]
140 In case a URL is given the file will get downloaded and registered to
142 be downloaded by the server as well via the download_url source ser‐
143 vice.
144 This is recommended for release tar balls to track their source and to
146 help others to review your changes esp. on version upgrades.
147 usage:
149 osc add URL [URL...]
150 osc add FILE [FILE...]
151 options:
153 -f, --force
155 add files even if they are excluded by the exclude_glob
156 config option
157 osc addchannels
160 Add channels to project
161 usage: osc [global opts] addchannels [-h] [-s] [-e]
163 The command adds all channels which are defined to be used for a given
165 source package. The source link target is used to lookup the channels.
166 The command can be used for a certain package or for all in the speci‐
167 fied project.
168 In case no channel is defined the operation is just returning.
170 Examples:
172 osc addchannels [PROJECT [PACKAGE]]
173 options:
175 -s, --skip-disabled
177 Skip disabled channels. Otherwise the source gets added,
178 but not the repositories.
179 -e, --enable-all
182 Enable all added channels including the ones disabled by
183 default.
184 osc addcontainers
187 Add maintained containers for a give package
188 usage: osc [global opts] addcontainers [-h] [--extend-package-names]
190 The command adds all containers which are marked as maintained and con‐
192 tain an rpm originating from the specified source package.
193 Examples:
195 osc addcontainers [PROJECT PACKAGE]
196 options:
198 --extend-package-names
200 Extend packages names with project name as suffix
201 osc addremove (ar)
204 Adds new files, removes disappeared files
205 usage: osc [global opts] addremove [-h] [-r]
207 Adds all files new in the local copy, and removes all disappeared
209 files.
210 ARG, if specified, is a package working copy.
212 options:
214 -r, --recursive
216 If CWD is a project dir then scan all package dirs as
217 well
218 osc aggregatepac
221 "Aggregate" a package to another package
222 usage: osc [global opts] aggregatepac [-h] [--nosources]
224 [-m SRC=TARGET[,SRC=TARGET]] [-d]
225 Aggregation of a package means that the build results (binaries) of a
227 package are basically copied into another project. This can be used to
228 make packages available from building that are needed in a project but
229 available only in a different project. Note that this is done at the
230 expense of disk space. See http://en.opensuse.org/openSUSE:Build_Ser‐
231 vice_Tips_and_Tricks#link_and_aggregate for more information.
232 The DESTPAC name is optional; the source packages' name will be used if
234 DESTPAC is omitted.
235 usage:
237 osc aggregatepac SOURCEPRJ SOURCEPAC[:FLAVOR] DESTPRJ [DESTPAC]
238 options:
240 --nosources
242 ignore source packages when copying build results to des‐
243 tination project
244 -m SRC=TARGET[,SRC=TARGET], --map-repo SRC=TARGET[,SRC=TARGET]
247 Allows repository mapping(s) to be given as SRC=TAR‐
248 GET[,SRC=TARGET]
249 -d, --disable-publish
252 disable publishing of the aggregated package
253 osc api
256 Issue an arbitrary request to the API
257 usage: osc [global opts] api [-h] [-X HTTP_METHOD] [-e] [-d STRING] [-T
259 FILE]
260 [-a NAME STRING NAME STRING]
261 url
262 Useful for testing.
264 URL can be specified either partially (only the path component), or
266 fully with URL scheme and hostname ('http://...').
267 Note the global -A and -H options (see osc help).
269 Examples:
271 osc api /source/home:user
272 osc api -X PUT -T /etc/fstab source/home:user/test5/myfstab
273 osc api -e /configuration
274 arguments:
276 url either URL '/path' or full URL with 'scheme://host‐
278 name/path'
279 options:
282 -X HTTP_METHOD, -m HTTP_METHOD, --method HTTP_METHOD
284 specify HTTP method to use (GET|PUT|DELETE|POST)
285 -e, --edit
288 GET, edit and PUT the location
289 -d STRING, --data STRING
292 specify string data for e.g. POST
293 -T FILE, -f FILE, --file FILE
296 specify filename to upload, uses PUT mode by default
297 -a NAME STRING NAME STRING, --add-header NAME STRING NAME STRING
300 add the specified header to the request
301 osc branch (getpac, bco, branchco)
304 Branch a package
305 usage: osc [global opts] branch [-h] [--nodevelproject] [-c] [-f]
307 [--add-repositories] [--extend-pack‐
308 age-names]
309 [--noaccess] [-m TEXT] [-M] [-N] [-r
310 rev]
311 [--linkrev linkrev]
312 [--add-repositories-block add_reposito‐
313 ries_block]
314 [--add-repositories-rebuild add_reposi‐
315 tories_rebuild]
316 [--disable-build]
317 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
319 information on this topic.]
320 Create a source link from a package of an existing project to a new
322 subproject of the requesters home project (home:branches:)
323 The branched package will live in
325 home:USERNAME:branches:PROJECT/PACKAGE if nothing else specified.
326 With getpac or bco, the branched package will come from one of
328 %(getpac_default_project)s (list of projects from oscrc:getpac_de‐
329 fault_project) if nothing else is specfied on the command line.
330 In case of branch errors, where the source has currently merge con‐
332 flicts use --linkrev=base option.
333 usage:
335 osc branch
336 osc branch SOURCEPROJECT SOURCEPACKAGE
337 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT|.
338 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT|. TARGETPACK‐
339 AGE
340 osc getpac SOURCEPACKAGE
341 osc bco ...
342 options:
344 --nodevelproject
346 do not follow a defined devel project (primary project
347 where a package is developed)
348 -c, --checkout
351 Checkout branched package afterwards using "co -e
352 -S"('osc bco' is a shorthand for this option)
353 -f, --force
356 force branch, overwrite target
357 --add-repositories
360 Add repositories to target project (happens by default
361 when project is new)
362 --extend-package-names
365 Extend packages names with project name as suffix
366 --noaccess
369 Create a hidden project
370 -m TEXT, --message TEXT
373 specify message TEXT
374 -M, --maintenance
377 Create project and package in maintenance mode
378 -N, --new-package
381 create a branch pointing to a not yet existing package
382 -r rev, --revision rev
385 branch against a specific revision
386 --linkrev linkrev
389 specify the used revision in the link target.
390 --add-repositories-block add_repositories_block
393 specify the used block strategy for new repositories
394 --add-repositories-rebuild add_repositories_rebuild
397 specify the used rebuild strategy for new repositories
398 --disable-build
401 disable building of the branched package
402 osc browse
405 Opens browser
406 usage: osc [global opts] browse [-h]
408 usage:
410 osc browse [PROJECT [PACKAGE]]
411 osc browse [REQUEST_ID]
412 osc build (wipe, shell, chroot)
414 Build a package on your local machine
415 usage: osc [global opts] build [-h] [--clean] [-o] [-l]
417 [--no-changelog]
418 [--rsync-src RSYNCSRCPATH]
419 [--rsync-dest RSYNCDESTPATH]
420 [--overlay OVERLAY] [--noinit]
421 [--nochecks]
422 [--no-verify] [--nodebugpackages]
423 [--skip-local-service-run] [-p DIR] [-k
424 DIR]
425 [-M FLAVOR] [-x PAC] [-X FILE] [--root
426 ROOT]
427 [-j N] [-t N] [--icecream N] [--ccache]
428 [--pkg-ccache /path/to/_ccache.tar]
429 [--sccache]
430 [--sccache-uri redis://127.0.0.1:6389]
431 [--with X] [--without X] [--define 'X
432 Y']
433 [--build-opt OPT] [--buildtool-opt OPT]
434 [--userootforbuild]
435 [--build-uid uid:gid|"caller"]
436 [--local-package] [--stage STAGE]
437 [--linksources] [--vm-memory MEMORY]
438 [--vm-disk-size DISKSIZE] [--vm-type
439 TYPE]
440 [--vm-telnet TELNET] [--target TARGET]
441 [--alternative-project PROJECT] [-d]
442 [--disable-debuginfo] [-b] [--release N]
443 [--disable-cpio-bulk-download]
444 [--download-api-only] [--oldpackages
445 DIR]
446 [--verbose-mode MODE] [--shell-af‐
447 ter-fail]
448 [--shell-cmd COMMAND] [-f] [--host HOST]
449 [--trust-all-projects] [--nopreinstal‐
450 limage]
451 [--just-print-buildroot]
452 The command works from a package checkout (local changes are fine).
454 You can use `osc repos` to look up REPOSITORY and ARCH arguments. If
456 they are not set, `osc` choses from configured repos in this priority:
457 1. `build_repository` mentioned in config file
458 2. "standard"
459 3. "openSUSE_Factory"
460 4. "openSUSE_Tumbleweed"
461 5. last repo from the sorted list
462 BUILD_DESCR is either a RPM spec file, or a Debian dsc file.
464 The command honors packagecachedir, build-root and build-uid settings
466 in oscrc, if present. You may want to set su-wrapper = 'sudo' in oscrc,
467 and configure sudo with option NOPASSWD for /usr/bin/build.
468 If neither --clean nor --noinit is given, build will reuse an existing
470 build-root again, removing unneeded packages and add missing ones. This
471 is usually the fastest option.
472 If the package doesn't exist on the server please use the --local-pack‐
474 age option. If the project of the package doesn't exist on the server
475 use the --alternative-project <alternative-project> option. Example:
476 osc build [OPTS] --alternative-project openSUSE:10.3 standard i586
477 BUILD_DESCR
478 usage:
480 osc build [OPTS] # will try to guess a build
481 environement
482 osc build [OPTS] REPOSITORY ARCH BUILD_DESCR
483 osc build [OPTS] REPOSITORY ARCH
484 osc build [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR is de‐
485 tected automatically)
486 osc build [OPTS] ARCH (REPOSITORY = build_repository (config op‐
487 tion), BUILD_DESCR is detected automatically)
488 osc build [OPTS] BUILD_DESCR (REPOSITORY = build_repository (config
489 option), ARCH = hostarch)
490 osc build [OPTS] (REPOSITORY = build_repository (config option),
491 ARCH = hostarch, BUILD_DESCR is detected automatically)
492 For debugging after a build you can jump into the build environment:
494 osc shell [OPTS] REPOSITORY ARCH
495 Run a single command inside of the build environment:
497 osc shell --shell-cmd=COMMAND [OPTS] REPOSITORY ARCH
498 Useful `shell` OPTS
500 --noinit # for faster run
501 --shell-cmd=COMMAND
502 --shell-after-fail
503 --extra-pkgs=PACKAGE # install additional packages
504 To clean up the build environment run
506 osc wipe [OPTS]
507 osc wipe [OPTS] REPOSITORY ARCH
508 If you've set the used VM type in oscrc, it can be also overridden here
510 --vm-type=chroot # for faster, but uncleaner and unsecure build
512 --vm-type=kvm # for clean and secure build
513 --vm-type=qemu # for slow cross architecture build using sys‐
514 tem emulator
515 # Note: # Configuration can be overridden by envvars, e.g. #
517 OSC_SU_WRAPPER overrides the setting of su-wrapper. # OSC_BUILD_ROOT
518 overrides the setting of build-root. # OSC_PACKAGECACHEDIR overrides
519 the setting of packagecachedir.
520 options:
522 --clean
524 Delete old build root before initializing it
525 -o, --offline
528 Start with cached prjconf and packages without contacting
529 the api server
530 -l, --preload
533 Preload all files into the cache for offline operation
534 --no-changelog
537 don't update the package changelog from a changes file
538 --rsync-src RSYNCSRCPATH
541 Copy folder to buildroot after installing all RPMs. Use
542 together with --rsync-dest. This is the path on the HOST
543 filesystem e.g. /tmp/linux-kernel-tree. It defines RSYNC‐
544 DONE 1 .
545 --rsync-dest RSYNCDESTPATH
548 Copy folder to buildroot after installing all RPMs. Use
549 together with --rsync-src. This is the path on the TARGET
550 filesystem e.g. /usr/src/packages/BUILD/linux-2.6 .
551 --overlay OVERLAY
554 Copy overlay filesystem to buildroot after installing all
555 RPMs .
556 --noinit, --no-init
559 Skip initialization of build root and start with build
560 immediately.
561 --nochecks, --no-checks
564 Do not run build checks on the resulting packages.
565 --no-verify, --noverify
568 Skip signature verification (via pgp keys) of packages
569 used for build. (Global config in oscrc: no_verify)
570 --nodebugpackages, --no-debug-packages
573 Skip installation of additional debug packages for CLI
574 builds
575 --skip-local-service-run, --noservice, --no-service
578 Skip run of local source services as specified in _ser‐
579 vice file.
580 -p DIR, --prefer-pkgs DIR
583 Prefer packages from this directory when installing the
584 build-root
585 -k DIR, --keep-pkgs DIR
588 Save built packages into this directory
589 -M FLAVOR, --multibuild-package FLAVOR
592 Only work with the specified flavor of a multibuild pack‐
593 age.
594 -x PAC, --extra-pkgs PAC
597 Add this package when installing the build-root
598 -X FILE, --extra-pkgs-from FILE
601 Add packages listed in this file when installing the
602 build-root
603 --root ROOT
606 Build in specified directory
607 -j N, --jobs N
610 Compile with N jobs
611 -t N, --threads N
614 Compile with N threads
615 --icecream N
618 use N parallel build jobs with icecream
619 --ccache
622 use ccache to speed up rebuilds
623 --pkg-ccache /path/to/_ccache.tar
626 path to an existing uncompressed archive ccache. Using
627 this option implies --ccache
628 --sccache
631 use sccache to speed up rebuilds. Conflicts with --cache
632 --sccache-uri redis://127.0.0.1:6389
635 Optional remote URI for sccache storage. Implies --sc‐
636 cache.
637 --with X
640 enable feature X for build
641 --without X
644 disable feature X for build
645 --define 'X Y'
648 define macro X with value Y
649 --build-opt OPT
652 pass option OPT to the build command
653 --buildtool-opt OPT
656 pass option OPT to the build tool command (rpmbuild)
657 --userootforbuild, --login-as-root
660 Run build or shell as root. The default is to build as
661 unprivileged user. Note that a line "# norootforbuild" in
662 the spec file will invalidate this option.
663 --build-uid uid:gid|"caller"
666 specify the numeric uid:gid pair to assign to the unpriv‐
667 ileged "abuild" user or use "caller" to use the current
668 user uid:gid
669 --local-package
672 build a package which does not exist on the server
673 --stage STAGE
676 runs a specific stage, default is "a" for all. Append a
677 trailing "="to only run the specified stage. Append a
678 trailing "+" to runthe specified stage and all stages
679 coming after it. With nosuffix, stages up to and included
680 the specified stage are run.
681 --linksources
684 use hard links instead of a deep copied source
685 --vm-memory MEMORY
688 amount of memory for VM defined in MB
689 --vm-disk-size DISKSIZE
692 size for newly created disk image in MB
693 --vm-type TYPE
696 use VM type TYPE (e.g. kvm)
697 --vm-telnet TELNET
700 Launch a telnet server inside of VM build
701 --target TARGET
704 define target platform
705 --alternative-project PROJECT
708 specify the build target project
709 -d, --debuginfo
712 also build debuginfo sub-packages
713 --disable-debuginfo
716 disable build of debuginfo packages
717 -b, --baselibs
720 Create -32bit/-64bit/-x86 rpms for other architectures
721 --release N
724 set release number of the package to N
725 --disable-cpio-bulk-download
728 disable downloading packages as cpio archive from api
729 --download-api-only
732 only fetch packages from the api
733 --oldpackages DIR
736 take previous build from DIR (special values: _self,
737 _link)
738 --verbose-mode MODE
741 set verbose mode of the "build" program, arguments can be
742 "all" or "vm"
743 --shell-after-fail
746 run a shell if the build tool fails
747 --shell-cmd COMMAND
750 run specified command instead of bash
751 -f, --force
754 Do not ask for confirmation to wipe
755 --host HOST
758 perform the build on a remote server - user@server:~/re‐
759 mote/directory
760 --trust-all-projects
763 trust packages from all projects
764 --nopreinstallimage, --no-preinstallimage
767 Do not use preinstall images for creating the build root.
768 --just-print-buildroot
771 Print build root path and exit.
772 osc buildconfig
775 Shows the build config
776 usage: osc [global opts] buildconfig [-h]
778 Shows the build configuration which is used in building a package.
780 This command is mostly used internally by the 'build' command.
781 The returned data is the project-wide build configuration in a format
783 which is directly readable by the build script. It contains RPM macros
784 and BuildRequires expansions, for example.
785 The argument REPOSITORY an be taken from the first column of the
787 usage:
789 osc buildconfig REPOSITORY (in pkg or prj dir)
790 osc buildconfig PROJECT REPOSITORY
791 osc buildhistory (buildhist)
793 Shows the build history of a package
794 usage: osc [global opts] buildhistory [-h] [--csv] [-l limit] [-M FLA‐
796 VOR]
797 The arguments REPOSITORY and ARCH can be taken from the first two col‐
799 umns of the 'osc repos' output.
800 usage:
802 osc buildhist REPOSITORY ARCHITECTURE
803 osc buildhist PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCHITECTURE
804 options:
806 --csv generate output in CSV (separated by |)
808 -l limit, --limit limit
811 for setting the number of results
812 -M FLAVOR, --multibuild-package FLAVOR
815 Only work with the specified flavor of a multibuild pack‐
816 age.
817 osc buildinfo
820 Shows the build info
821 usage: osc [global opts] buildinfo [-h] [--alternative-project PROJECT]
823 [-d]
824 [-M FLAVOR] [-x PAC] [-p DIR]
825 Shows the build "info" which is used in building a package. This com‐
827 mand is mostly used internally by the 'build' subcommand. It needs to
828 be called from within a package directory.
829 The BUILD_DESCR argument is optional. BUILD_DESCR is a local RPM spec‐
831 file or Debian "dsc" file. If specified, it is sent to the server, and
832 the buildinfo will be based on it. If the argument is not supplied, the
833 buildinfo is derived from the specfile which is currently on the source
834 repository server.
835 The returned data is XML and contains a list of the packages used in
837 building, their source, and the expanded BuildRequires.
838 The arguments REPOSITORY and ARCH are optional. They can be taken from
840 the first two columns of the 'osc repos' output. If not specified,
841 REPOSITORY defaults to the 'build_repository' config entry in your 'os‐
842 crc' and ARCH defaults to your host architecture.
843 usage:
845 in a package working copy:
846 osc buildinfo [OPTS] REPOSITORY ARCH BUILD_DESCR
847 osc buildinfo [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR
848 is detected automatically)
849 osc buildinfo [OPTS] ARCH (REPOSITORY = build_repository (con‐
850 fig option), BUILD_DESCR is detected automatically)
851 osc buildinfo [OPTS] BUILD_DESCR (REPOSITORY = build_repository
852 (config option), ARCH = hostarch)
853 osc buildinfo [OPTS] (REPOSITORY = build_repository (config op‐
854 tion), ARCH = hostarch, BUILD_DESCR is detected automatically)
855 Note: if BUILD_DESCR does not exist locally the remote
856 BUILD_DESCR is used
857 osc buildinfo [OPTS] PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH
859 [BUILD_DESCR]
860 options:
862 --alternative-project PROJECT
864 specify the build target project
865 -d, --debug
868 verbose output of build dependencies
869 -M FLAVOR, --multibuild-package FLAVOR
872 Only work with the specified flavor of a multibuild pack‐
873 age.
874 -x PAC, --extra-pkgs PAC
877 Add this package when computing the buildinfo
878 -p DIR, --prefer-pkgs DIR
881 Prefer packages from this directory when installing the
882 build-root
883 osc buildlog (buildlogtail, blt, bl)
886 Shows the build log of a package
887 usage: osc [global opts] buildlog [-h] [-l] [--lastsucceeded] [-M FLA‐
889 VOR]
890 [-o OFFSET] [-s]
891 Shows the log file of the build of a package. Can be used to follow the
893 log while it is being written. Needs to be called from within a pack‐
894 age directory.
895 When called as buildlogtail (or blt) it just shows the end of the log‐
897 file. This is useful to see just a build failure reasons.
898 The arguments REPOSITORY and ARCH are the first two columns in the 'osc
900 results' output. If the buildlog url is used buildlog command has the
901 same behavior as remotebuildlog.
902 buildlog [REPOSITORY ARCH | BUILDLOGURL]
904 options:
906 -l, --last
908 Show the last finished log file
909 --lastsucceeded, --last-succeeded
912 Show the last succeeded log file
913 -M FLAVOR, --multibuild-package FLAVOR
916 Only work with the specified flavor of a multibuild pack‐
917 age.
918 -o OFFSET, --offset OFFSET
921 get log start or end from the offset
922 -s, --strip-time
925 strip leading build time from the log
926 osc cat (less, blame)
929 Output the content of a file to standard output
930 usage: osc [global opts] cat [-h] [-r rev] [-e] [-u] [-D] [-M]
932 Examples:
934 osc cat file
935 osc cat project package file
936 osc cat project/package/file
937 osc cat http://api.opensuse.org/build/.../_log
938 osc cat http://api.opensuse.org/source/../_link
939 osc less file
941 osc less project package file
942 osc blame file
944 osc blame project package file
945 options:
947 -r rev, --revision rev
949 print out the specified revision
950 -e, --expand
953 (default) force expansion of linked packages.
954 -u, --unexpand
957 always work with unexpanded packages.
958 -D, --deleted
961 access file in a deleted package
962 -M, --meta
965 list meta data files
966 osc changedevelrequest (changedevelreq, cr)
969 Create request to change the devel package definition
970 usage: osc [global opts] changedevelrequest [-h] [-m TEXT]
972 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
974 information on this topic.]
975 See the "request" command for showing and modifying existing requests.
977 usage:
979 osc changedevelrequest PROJECT PACKAGE DEVEL_PROJECT [DEVEL_PACK‐
980 AGE]
981 options:
983 -m TEXT, --message TEXT
985 specify message TEXT
986 osc checkconstraints
989 Check the constraints and view compliant workers
990 usage: osc [global opts] checkconstraints [-h] [--ignore-file] [-M FLA‐
992 VOR]
993 Checks the constraints for compliant workers.
995 usage:
997 remote request:
998 osc checkconstraints [OPTS] PROJECT PACKAGE REPOSITORY ARCH
999 [CONSTRAINTSFILE]
1000 in a package working copy:
1002 osc checkconstraints [OPTS] REPOSITORY ARCH [CONSTRAINTSFILE]
1003 osc checkconstraints [OPTS] CONSTRAINTSFILE
1004 osc checkconstraints [OPTS]
1005 options:
1007 --ignore-file
1009 ignore _constraints file and only check project con‐
1010 straints
1011 -M FLAVOR, --multibuild-package FLAVOR
1014 Only work with the specified flavor of a multibuild pack‐
1015 age.
1016 osc checkout (co)
1019 Check out content from the repository
1020 usage: osc [global opts] checkout [-h] [-r rev] [-e] [-D] [-u] [-M]
1022 [-c]
1023 [-o outdir] [-s] [-S] [-l limit_size]
1024 Check out content from the repository server, creating a local working
1026 copy.
1027 When checking out a single package, the option --revision can be used
1029 to specify a revision of the package to be checked out.
1030 When a package is a source link, then it will be checked out in ex‐
1032 panded form. If --unexpand-link option is used, the checkout will in‐
1033 stead produce the raw _link file plus patches.
1034 usage:
1036 osc co PROJECT [PACKAGE] [FILE]
1037 osc co PROJECT # entire project
1038 osc co PROJECT PACKAGE # a package
1039 osc co PROJECT PACKAGE FILE # single file -> to current
1040 dir
1041 while inside a project directory:
1043 osc co PACKAGE # check out PACKAGE from
1044 project
1045 with the result of rpm -q --qf '%%{DISTURL}\n' PACKAGE
1047 osc co obs://API/PROJECT/PLATFORM/REVISION-PACKAGE
1048 options:
1050 -r rev, --revision rev
1052 checkout the specified revision. NOTE: if you checkout
1053 the complete project this option is ignored!
1054 -e, --expand-link
1057 if a package is a link, check out the expanded sources
1058 (no-op, since this became the default)
1059 -D, --deleted
1062 checkout an already deleted package. No meta information
1063 -u, --unexpand-link
1066 if a package is a link, check out the _link file instead
1067 of the expanded sources
1068 -M, --meta
1071 checkout out meta data instead of sources
1072 -c, --current-dir
1075 place PACKAGE folder in the current directory instead of
1076 a PROJECT/PACKAGE directory
1077 -o outdir, --output-dir outdir
1080 place package in the specified directory instead of a
1081 PROJECT/PACKAGE directory
1082 -s, --source-service-files
1085 Run source services.
1086 -S, --server-side-source-service-files
1089 Use server side generated sources instead of local gener‐
1090 ation.
1091 -l limit_size, --limit-size limit_size
1094 Skip all files with a given size
1095 osc clean
1098 Removes all untracked files from the package working copy
1099 usage: osc [global opts] clean [-h] [-n]
1101 Examples:
1103 osc clean <path>
1104 Note: if <path> is omitted it defaults to '.' (<path> has to be a pack‐
1106 age working copy)
1107 Warning: This command removes all files with status '?'.
1109 options:
1111 -n, --dry-run
1113 print the results without actually removing a file
1114 osc cleanassets (ca)
1117 Clean all previous downloaded assets
1118 usage: osc [global opts] cleanassets [-h]
1120 This is useful to prepare a new git commit.
1122 osc comment
1124 List / create / delete comments
1125 usage: osc [global opts] comment [-h] [-c COMMENT] [-p PARENT]
1127 On create:
1129 If -p is given a reply to the ID is created. Otherwise
1130 a toplevel comment is created.
1131 If -c is not given the default editor will be opened and
1132 you can type your comment
1133 usage:
1135 osc comment list package PROJECT PACKAGE
1136 osc comment list project PROJECT
1137 osc comment list request REQUEST_ID
1138 osc comment create [-p PARENT_ID] [-c COMMENT] package PROJECT
1140 PACKAGE
1141 osc comment create [-p PARENT_ID] [-c COMMENT] project PROJECT
1142 osc comment create [-p PARENT_ID] [-c COMMENT] request REQUEST_ID
1143 osc comment delete ID
1145 options:
1147 -c COMMENT, --comment COMMENT
1149 comment text
1150 -p PARENT, --parent PARENT
1153 reply to comment with parent id
1154 osc commit (checkin, ci)
1157 Upload content to the repository server
1158 usage: osc [global opts] commit [-h] [-m TEXT] [-n] [-F FILE] [-f]
1160 [--skip-local-service-run]
1161 Upload content which is changed in your working copy, to the repository
1163 server.
1164 examples:
1166 osc ci # current dir
1167 osc ci <dir>
1168 osc ci file1 file2 ...
1169 options:
1171 -m TEXT, --message TEXT
1173 specify log message TEXT
1174 -n, --no-message
1177 do not specify a log message
1178 -F FILE, --file FILE
1181 read log message from FILE, '-' denotes standard input.
1182 -f, --force
1185 Allow empty commit with no changes. When commiting a
1186 project, allow removing packages even if other packages
1187 depend on them.
1188 --skip-local-service-run, --noservice, --no-service
1191 Skip run of local source services as specified in _ser‐
1192 vice file.
1193 osc config
1196 Get/set a config option
1197 usage: osc [global opts] config [-h] [-d] [-s] [-p] [--change-password]
1199 [--select-password-store] [--no-echo]
1200 [--dump]
1201 [--dump-full]
1202 Examples:
1204 osc config section option (get current value)
1205 osc config section option value (set to value)
1206 osc config section option --delete (delete option/reset to the de‐
1207 fault)
1208 osc config section --change-password (changes the password in sec‐
1209 tion "section")
1210 (section is either an apiurl or an alias or 'general')
1211 osc config --dump (dump the complete configuration)
1212 options:
1214 -d, --delete
1216 delete option from config or reset option to the default)
1217 -s, --stdin
1220 indicates that the config value should be read from stdin
1221 -p, --prompt
1224 prompt for a value
1225 --change-password
1228 Change password
1229 --select-password-store
1232 Change the password store
1233 --no-echo
1236 prompt for a value but do not echo entered characters
1237 --dump dump the complete configuration (without 'pass' and
1240 'passx' options)
1241 --dump-full
1244 dump the complete configuration (including 'pass' and
1245 'passx' options)
1246 osc copypac
1249 Copy a package
1250 usage: osc [global opts] copypac [-h] [-c] [-k] [-K] [-d] [-r rev] [-t
1252 URL]
1253 [-m TEXT] [-e]
1254 A way to copy package to somewhere else.
1256 It can be done across buildservice instances, if the -t option is used.
1258 In that case, a client-side copy and link expansion are implied.
1259 Using --client-side-copy always involves downloading all files, and up‐
1261 loading them to the target.
1262 The DESTPAC name is optional; the source packages' name will be used if
1264 DESTPAC is omitted.
1265 If SOURCEPRJ or DESTPRJ is '.' it will be expanded to the PRJ of the
1267 current directory.
1268 usage:
1270 osc copypac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC]
1271 options:
1273 -c, --client-side-copy
1275 do a (slower) client-side copy
1276 -k, --keep-maintainers
1279 keep original maintainers. Default is remove all and re‐
1280 place with the one calling the script.
1281 -K, --keep-link
1284 If the target package is a link, the link is kept, but
1285 may be updated. If the source package is a link, its ex‐
1286 panded version is considered.
1287 -d, --keep-develproject
1290 keep develproject tag in the package metadata
1291 -r rev, --revision rev
1294 copy the specified revision.
1295 -t URL, --to-apiurl URL
1298 URL of destination api server. Default is the source api
1299 server.
1300 -m TEXT, --message TEXT
1303 specify message TEXT
1304 -e, --expand
1307 if the source package is a link then copy the expanded
1308 version of the link
1309 osc create-pbuild-config (cpc)
1312 This command is creating the necessary files to build using pbuild
1313 tool.
1314 usage: osc [global opts] create-pbuild-config [-h] repository arch
1316 It basically creates _config and _pbuild file in the project directory.
1318 Changes from there can not get submitted back, except the project is
1319 managed in git.
1320 Examples:
1322 osc cpc REPOSITORY ARCH
1323 arguments:
1325 repository
1327 arch
1330 osc createincident
1333 Create a maintenance incident
1334 usage: osc [global opts] createincident [-h] [-a ATTRIBUTE] [--noac‐
1336 cess]
1337 [-m TEXT]
1338 [See https://openbuildservice.org/help/manu‐
1340 als/obs-user-guide/cha.obs.maintenance_setup.html for information on
1341 this topic.]
1342 This command is asking to open an empty maintenance incident. This can
1344 usually only be done by a responsible maintenance team. Please see the
1345 "mbranch" command on how to full such a project content and the "patch‐
1346 info" command how add the required maintenance update information.
1347 usage:
1349 osc createincident [ MAINTENANCEPROJECT ]
1350 options:
1352 -a ATTRIBUTE, --attribute ATTRIBUTE
1354 Use this attribute to find default maintenance project
1355 (default is OBS:MaintenanceProject)
1356 --noaccess
1359 Create a hidden project
1360 -m TEXT, --message TEXT
1363 specify message TEXT
1364 osc createrequest (creq)
1367 Create multiple requests with a single command
1368 usage: osc [global opts] createrequest [-h] [-a ACTION [[ARGS] ...]]
1370 [-m TEXT]
1371 [-r REV] [-s REQUEST_ID]
1372 [--nodevelproject] [--cleanup]
1373 [--no-cleanup] [--no-update]
1374 [--yes]
1375 usage:
1377 osc creq [OPTIONS] [
1378 -a submit SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
1379 -a delete PROJECT [PACKAGE]
1380 -a change_devel PROJECT PACKAGE DEVEL_PROJECT [DEVEL_PACKAGE]
1381 -a add_me ROLE PROJECT [PACKAGE]
1382 -a add_group GROUP ROLE PROJECT [PACKAGE]
1383 -a add_role USER ROLE PROJECT [PACKAGE]
1384 -a set_bugowner USER PROJECT [PACKAGE]
1385 ]
1386 Option -m works for all types of request, the rest work only for
1388 submit.
1389 Example:
1391 osc creq -a submit -a delete home:someone:branches:openSUSE:Tools
1392 -a change_devel openSUSE:Tools osc home:someone:branches:openSUSE:Tools
1393 -m ok
1394 This will submit all modified packages under current directory,
1396 delete project home:someone:branches:openSUSE:Tools and change the de‐
1397 vel project to home:someone:branches:openSUSE:Tools for package osc in
1398 project openSUSE:Tools.
1399 options:
1401 -a ACTION [[ARGS] ...], --action ACTION [[ARGS] ...]
1403 specify action type of a request, can be : sub‐
1404 mit/delete/change_devel/add_role/set_bugowner
1405 -m TEXT, --message TEXT
1408 specify message TEXT
1409 -r REV, --revision REV
1412 for "create", specify a certain source revision ID (the
1413 md5 sum)
1414 -s REQUEST_ID, --supersede REQUEST_ID
1417 Superseding another request by this one
1418 --nodevelproject
1421 do not follow a defined devel project (primary project
1422 where a package is developed)
1423 --cleanup
1426 remove package if submission gets accepted (default for
1427 home:<id>:branch projects)
1428 --no-cleanup
1431 never remove source package on accept, but update its
1432 content
1433 --no-update
1436 never touch source package on accept (will break source
1437 links)
1438 --yes proceed without asking.
1441 osc delete (remove, del, rm)
1444 Mark files or package directories to be deleted upon the next 'checkin'
1445 usage: osc [global opts] delete [-h] [-f]
1447 usage:
1449 cd .../PROJECT/PACKAGE
1450 osc delete FILE [...]
1451 cd .../PROJECT
1452 osc delete PACKAGE [...]
1453 This command works on check out copies. Use "rdelete" for working on
1455 server side only. This is needed for removing the entire project.
1456 As a safety measure, projects must be empty (i.e., you need to delete
1458 all packages first).
1459 If you are sure that you want to remove a package and all its files use
1461 '--force' switch. Sometimes this also works without --force.
1462 options:
1464 -f, --force
1466 forces removal of entire package and its files
1467 osc deleterequest (deletereq, droprequest, dropreq, dr)
1470 Request to delete (or 'drop') a package or project
1471 usage: osc [global opts] deleterequest [-h] [-m TEXT] [-r REPOSITORY]
1473 [--all]
1474 [--accept-in-hours HOURS]
1475 usage:
1477 osc deletereq [-m TEXT] # works in checked out
1478 project/package
1479 osc deletereq [-m TEXT] PROJECT PACKAGE
1480 osc deletereq [-m TEXT] PROJECT [--all|--repository REPOSITORY]
1481 options:
1483 -m TEXT, --message TEXT
1485 specify message TEXT
1486 -r REPOSITORY, --repository REPOSITORY
1489 specify repository
1490 --all deletes entire project with packages inside
1493 --accept-in-hours HOURS
1496 specify time when request shall get accepted automati‐
1497 cally. Only works with write permissions in target.
1498 osc dependson
1501 Dependson shows the build dependencies inside of a project, valid for a
1502 given repository and architecture
1503 usage: osc [global opts] dependson [-h]
1505 The command can be used to find build dependencies (wrt. a given repos‐
1507 itory and arch) that reside in the same project. To see all build de‐
1508 pendencies use the buildinfo command.
1509 This is no guarantee, since the new build might have changed dependen‐
1511 cies.
1512 NOTE: to see all binary packages, which can trigger a build you need to
1514 refer the buildinfo, since this command shows only the dependen‐
1515 cies
1516 inside of a project.
1517 The arguments REPOSITORY and ARCH can be taken from the first two col‐
1519 umns of the 'osc repos' output.
1520 usage in package or project directory:
1522 osc dependson REPOSITORY ARCH
1523 usage:
1525 osc dependson PROJECT [PACKAGE] REPOSITORY ARCH
1526 osc detachbranch
1528 Replace a link with its expanded sources
1529 usage: osc [global opts] detachbranch [-h] [-m TEXT]
1531 If a package is a link it is replaced with its expanded sources. The
1533 link does not exist anymore.
1534 usage:
1536 osc detachbranch # from a package working copy
1537 osc detachbranch PROJECT PACKAGE
1538 options:
1540 -m TEXT, --message TEXT
1542 specify message TEXT
1543 osc develproject (dp, bsdevelproject)
1546 Print the devel project / package of a package
1547 usage: osc [global opts] develproject [-h]
1549 Examples:
1551 osc develproject [PROJECT PACKAGE]
1552 osc diff (di, ldiff, linkdiff)
1554 Generates a diff
1555 usage: osc [global opts] diff [-h] [-c rev] [-r rev1[:rev2]] [-M] [-p]
1557 [-l]
1558 [--missingok] [-u]
1559 Generates a diff, comparing local changes against the repository
1561 server.
1562 usage:
1564 ARG, if specified, is a filename to include in the diff.
1565 Default: all files.
1566 osc diff --link
1568 osc linkdiff
1569 Compare current checkout directory against the link base.
1570 osc diff --link PROJ PACK
1572 osc linkdiff PROJ PACK
1573 Compare a package against the link base (ignoring working copy
1574 changes).
1575 options:
1577 -c rev, --change rev
1579 the change made by revision rev (like -r rev-1:rev).If
1580 rev is negative this is like -r rev:rev-1.
1581 -r rev1[:rev2], --revision rev1[:rev2]
1584 If rev1 is specified it will compare your working copy
1585 against the revision (rev1) on the server. If rev1 and
1586 rev2 are specified it will compare rev1 against rev2
1587 (NOTE: changes in your working copy are ignored in this
1588 case)
1589 -M, --meta
1592 operate on meta files
1593 -p, --plain
1596 output the diff in plain (not unified) diff format
1597 -l, --link
1600 (osc linkdiff): compare against the base revision of the
1601 link
1602 --missingok
1605 do not fail if the source or target project/package does
1606 not exist on the server
1607 -u, --unexpand
1610 Local changes only, ignore changes in linked package
1611 sources
1612 osc distributions (dists)
1615 Shows all available distributions
1616 usage: osc [global opts] distributions [-h]
1618 This command shows the available distributions. For active distribu‐
1620 tions it shows the name, project and name of the repository and a sug‐
1621 gested default repository name.
1622 usage:
1624 osc distributions
1625 osc downloadassets (da)
1627 Download all assets referenced in the build descriptions
1628 usage: osc [global opts] downloadassets [-h]
1630 osc enablechannels (enablechannel)
1632 Enables channels
1633 usage: osc [global opts] enablechannels [-h]
1635 Enables existing channel packages in a project. Enabling means adding
1637 the needed repositories for building. The command can be used to en‐
1638 able a specific one or all channels of a project.
1639 Examples:
1641 osc enablechannels [PROJECT [PACKAGE]]
1642 osc getbinaries
1644 Download binaries to a local directory
1645 usage: osc [global opts] getbinaries [-h] [-d DIR] [-M FLAVOR]
1647 [--sources]
1648 [--debuginfo] [--ccache]
1649 This command downloads packages directly from the api server. Thus, it
1651 directly accesses the packages that are used for building others even
1652 when they are not "published" yet.
1653 usage:
1655 osc getbinaries REPOSITORY # works
1656 in checked out project/package (check out all archs in subdirs)
1657 osc getbinaries REPOSITORY ARCHITECTURE # works
1658 in checked out project/package
1659 osc getbinaries PROJECT REPOSITORY ARCHITECTURE
1660 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE
1661 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE FILE
1662 options:
1664 -d DIR, --destdir DIR
1666 destination directory
1667 -M FLAVOR, --multibuild-package FLAVOR
1670 Get binaries from the specified flavor of a multibuild
1671 package. It is meant for use from a package checkout when
1672 it is not possible to specify package:flavor.
1673 --sources
1676 also fetch source packages
1677 --debuginfo
1680 also fetch debug packages
1681 --ccache
1684 allow fetching ccache archive
1685 osc help (?)
1688 Give detailed help on a specific sub-command
1689 usage: osc [global opts] help [-h]
1691 usage:
1693 %(prog)s [SUBCOMMAND]
1694 osc importsrcpkg
1696 Import a new package from a src.rpm
1697 usage: osc [global opts] importsrcpkg [-h] [-p project] [-n name] [-t
1699 title]
1700 [-d description]
1701 [--delete-old-files]
1702 [-c]
1703 srpm
1704 A new package dir will be created inside the project dir (if no project
1706 is specified and the current working dir is a project dir the package
1707 will be created in this project). If the package does not exist on the
1708 server it will be created too otherwise the meta data of the existing
1709 package will be updated (<title /> and <description />). The src.rpm
1710 will be extracted into the package dir. The files won't be committed
1711 unless you explicitly pass the --commit switch.
1712 SRPM is the path of the src.rpm in the local filesystem, or an URL.
1714 arguments:
1716 srpm
1718 options:
1721 -p project, --project project
1723 specify the path to a project
1724 -n name, --name name
1727 specify a package name
1728 -t title, --title title
1731 set a title
1732 -d description, --description description
1735 set the description of the package
1736 --delete-old-files
1739 delete existing files from the server
1740 -c, --commit
1743 commit the new files
1744 osc info
1747 Print information about a working copy
1748 usage: osc [global opts] info [-h]
1750 Print information about each ARG (default: '.') ARG is a working-copy
1752 path.
1753 osc init
1755 Initialize a directory as working copy
1756 usage: osc [global opts] init [-h] project [package] [scm_url]
1758 Initialize an existing directory to be a working copy of an (already
1760 existing) buildservice project/package.
1761 (This is the same as checking out a package and then copying sources
1763 into the directory. It does NOT create a new package. To create a pack‐
1764 age, use 'osc meta pkg ... ...')
1765 You wouldn't normally use this command.
1767 To get a working copy of a package (e.g. for building it or working on
1769 it, you would normally use the checkout command. Use "osc help check‐
1770 out" to get help for it.
1771 usage:
1773 osc init PRJ
1774 osc init PRJ PAC
1775 osc init PRJ PAC SCM_URL
1776 arguments:
1778 project
1780 package
1783 scm_url
1786 osc jobhistory (jobhist)
1789 Shows the job history of a project
1790 usage: osc [global opts] jobhistory [-h] [--csv] [-l limit] [-M FLAVOR]
1792 The arguments REPOSITORY and ARCH can be taken from the first two col‐
1794 umns of the 'osc repos' output.
1795 usage:
1797 osc jobhist REPOSITORY ARCHITECTURE (in project dir)
1798 osc jobhist PROJECT [PACKAGE[:FLAVOR]] REPOSITORY ARCHITECTURE
1799 options:
1801 --csv generate output in CSV (separated by |)
1803 -l limit, --limit limit
1806 for setting the number of results
1807 -M FLAVOR, --multibuild-package FLAVOR
1810 Only work with the specified flavor of a multibuild pack‐
1811 age.
1812 osc linkpac
1815 "Link" a package to another package
1816 usage: osc [global opts] linkpac [-h] [-C {add,copy,local}] [-c] [-r
1818 rev] [-f]
1819 [--disable-build] [-d] [-N]
1820 A linked package is a clone of another package, but plus local modifi‐
1822 cations. It can be cross-project.
1823 The TARGET_PACKAGE name is optional; the source packages' name will be
1825 used if TARGET_PACKAGE is omitted.
1826 Afterwards, you will want to 'checkout TARGET_PROJECT TARGET_PACKAGE'.
1828 To add a patch, add the patch as file and add it to the _link file.
1830 You can also specify text which will be inserted at the top of the spec
1831 file.
1832 See the examples in the _link file.
1834 NOTE: In case you want to fix or update another package, you should use
1836 the 'branch'
1837 command. A branch has correct repositories (and a link) setup up
1838 by default and
1839 will be cleaned up automatically after it was submitted back.
1840 usage:
1842 osc linkpac PROJECT PACKAGE TARGET_PROJECT [TARGET_PACKAGE]
1843 osc linkpac TARGET_PROJECT [TARGET_PACKAGE] # from a package
1844 checkout
1845 options:
1847 -C {add,copy,local}, --cicount {add,copy,local}
1849 cicount attribute in the link, known values are add,
1850 copy, and local, default in buildservice is currently
1851 add.
1852 -c, --current
1855 link fixed against current revision.
1856 -r rev, --revision rev
1859 link the specified revision.
1860 -f, --force
1863 overwrite an existing link file if it is there.
1864 --disable-build
1867 disable building of the linked package
1868 -d, --disable-publish
1871 disable publishing of the linked package
1872 -N, --new-package
1875 create a link to a not yet existing package
1876 osc linktobranch
1879 Convert a package containing a classic link with patch to a branch
1880 usage: osc [global opts] linktobranch [-h]
1882 This command tells the server to convert a _link with or without a
1884 project.diff to a branch. This is a full copy with a _link file point‐
1885 ing to the branched place.
1886 usage:
1888 osc linktobranch # from a package working copy
1889 osc linktobranch PROJECT PACKAGE
1890 osc list (LL, lL, ll, ls)
1892 List sources or binaries on the server
1893 usage: osc [global opts] list [-h] [-a ARCH] [-r REPO] [-b] [-e] [-u]
1895 [-l]
1896 [-D] [-M] [-R REVISION]
1897 Examples for listing sources:
1899 ls # list all projects (deprecated)
1900 ls / # list all projects
1901 ls . # take PROJECT/PACKAGE from current dir.
1902 ls PROJECT # list packages in a project
1903 ls PROJECT PACKAGE # list source files of package of a
1904 project
1905 ls PROJECT PACKAGE <file> # list <file> if this file exists
1906 ls -v PROJECT PACKAGE # verbosely list source files of package
1907 ls -l PROJECT PACKAGE # verbosely list source files of package
1908 ll PROJECT PACKAGE # verbosely list source files of package
1909 LL PROJECT PACKAGE # verbosely list source files of ex‐
1910 panded link
1911 With --verbose, the following fields will be shown for each item:
1913 MD5 hash of file
1914 Revision number of the last commit
1915 Size (in bytes)
1916 Date and time of the last commit
1917 Examples for listing binaries:
1919 ls -b PROJECT # list all binaries of a project
1920 ls -b PROJECT -a ARCH # list ARCH binaries of a project
1921 ls -b PROJECT -r REPO # list binaries in REPO
1922 ls -b PROJECT PACKAGE REPO ARCH
1923 usage:
1925 ls [PROJECT [PACKAGE]]
1926 ls -b [PROJECT [PACKAGE [REPO [ARCH]]]]
1927 options:
1929 -a ARCH, --arch ARCH
1931 specify architecture (only for binaries)
1932 -r REPO, --repo REPO
1935 specify repository (only for binaries)
1936 -b, --binaries
1939 list built binaries instead of sources
1940 -e, --expand
1943 expand linked package (only for sources)
1944 -u, --unexpand
1947 always work with unexpanded (source) packages
1948 -l, --long
1951 print extra information
1952 -D, --deleted
1955 show only the former deleted projects or packages
1956 -M, --meta
1959 list meta data files
1960 -R REVISION, --revision REVISION
1963 specify revision (only for sources)
1964 osc localbuildlog (lbl)
1967 Shows the build log of a local buildchroot
1968 usage: osc [global opts] localbuildlog [-h] [-o OFFSET] [-s]
1970 usage:
1972 osc lbl [REPOSITORY [ARCH]]
1973 osc lbl # show log of newest last local build
1974 options:
1976 -o OFFSET, --offset OFFSET
1978 get log starting from offset
1979 -s, --strip-time
1982 strip leading build time from the log
1983 osc lock
1986 Locks a project or package
1987 usage: osc [global opts] lock [-h] [-m TEXT]
1989 usage:
1991 osc lock PROJECT [PACKAGE]
1992 options:
1994 -m TEXT, --message TEXT
1996 specify log message TEXT
1997 osc log
2000 Shows the commit log of a package
2001 usage: osc [global opts] log [-h] [-r rev] [--csv] [--xml] [-D] [-M]
2003 usage:
2005 osc log (inside working copy)
2006 osc log remote_project [remote_package]
2007 options:
2009 -r rev, --revision rev
2011 show log of the specified revision
2012 --csv generate output in CSV (separated by |)
2015 --xml generate output in XML
2018 -D, --deleted
2021 work on deleted package
2022 -M, --meta
2025 checkout out meta data instead of sources
2026 osc maintainer (bugowner)
2029 Show maintainers according to server side configuration
2030 usage: osc [global opts] maintainer [-h] [-b] [-B] [-e] [--nodevelpro‐
2032 ject]
2033 [-D devel_project] [-a user] [-A]
2034 [-s user] [-S user] [-U USER] [-G
2035 GROUP]
2036 [-d user] [-r role] [-m MESSAGE]
2037 # Search for official maintained sources in OBS instance osc maintainer
2039 BINARY_OR_PACKAGE_NAME <options> osc maintainer -U <user> <options> osc
2040 maintainer -G <group> <options>
2041 # Lookup via containers osc maintainer <options> osc maintainer PRJ
2043 <options> osc maintainer PRJ PKG <options>
2044 The tool looks up the default responsible person for a certain project
2046 or package. When using with an OBS 2.4 (or later) server it is doing
2047 the lookup for a given binary according to the server side configura‐
2048 tion of default owners.
2049 The tool is also looking into devel packages and supports to fallback
2051 to the project in case a package has no defined maintainer.
2052 Please use "osc meta pkg" in case you need to know the definition in a
2054 specific container.
2055 PRJ and PKG default to current working-copy path.
2057 options:
2059 -b, --bugowner-only
2061 Show only the bugowner
2062 -B, --bugowner
2065 Show only the bugowner if defined, or maintainer other‐
2066 wise
2067 -e, --email
2070 show email addresses instead of user names
2071 --nodevelproject
2074 do not follow a defined devel project (primary project
2075 where a package is developed)
2076 -D devel_project, --devel-project devel_project
2079 define the project where this package is primarily devel‐
2080 oped
2081 -a user, --add user
2084 add a new person for given role ("maintainer" by default)
2085 -A, --all
2088 list all found entries not just the first one
2089 -s user, --set-bugowner user
2092 Set the bugowner to specified person (or group via group:
2093 prefix)
2094 -S user, --set-bugowner-request user
2097 Set the bugowner to specified person via a request (or
2098 group via group: prefix)
2099 -U USER, --user USER
2102 All official maintained instances for the specified USER
2103 -G GROUP, --group GROUP
2106 All official maintained instances for the specified GROUP
2107 -d user, --delete user
2110 delete a maintainer/bugowner (can be specified via
2111 --role)
2112 -r role, --role role
2115 Specify user role
2116 -m MESSAGE, --message MESSAGE
2119 Define message as commit entry or request description
2120 osc maintenancerequest (mr)
2123 Create a request for starting a maintenance incident
2124 usage: osc [global opts] maintenancerequest [-h] [-a ATTRIBUTE] [-m
2126 TEXT]
2127 [--release-project RELEASE‐
2128 PROJECT]
2129 [--enforce-branching]
2130 [--no-cleanup] [--cleanup]
2131 [--incident INCIDENT]
2132 [--incident-project INCI‐
2133 DENT_PROJECT]
2134 [-s REQUEST_ID]
2135 [See https://openbuildservice.org/help/manu‐
2137 als/obs-user-guide/cha.obs.maintenance_setup.html for information on
2138 this topic.]
2139 This command is asking the maintenance team to start a maintenance in‐
2141 cident based on a created maintenance update. Please see the "mbranch"
2142 command on how to create such a project and the "patchinfo" command how
2143 add the required maintenance update information.
2144 usage:
2146 osc maintenancerequest [ SOURCEPROJECT [ SOURCEPACKAGES RELEASEPRO‐
2147 JECT ] ]
2148 osc maintenancerequest .
2149 The 2nd line when issued within a package directory provides a short
2151 cut to submit a single package (the one in the current directory) from
2152 the project of this package to be submitted to the release project this
2153 package links to. This syntax is only valid when specified from a pack‐
2154 age subdirectory.
2155 options:
2157 -a ATTRIBUTE, --attribute ATTRIBUTE
2159 Use this attribute to find default maintenance project
2160 (default is OBS:MaintenanceProject)
2161 -m TEXT, --message TEXT
2164 specify message TEXT
2165 --release-project RELEASEPROJECT
2168 Specify the release project
2169 --enforce-branching
2172 submit from a fresh branched project
2173 --no-cleanup
2176 do not remove source project on accept
2177 --cleanup
2180 do remove source project on accept
2181 --incident INCIDENT
2184 specify incident number to merge in
2185 --incident-project INCIDENT_PROJECT
2188 specify incident project to merge in
2189 -s REQUEST_ID, --supersede REQUEST_ID
2192 Superseding another request by this one
2193 osc mbranch (maintained, sm)
2196 Search or branch multiple instances of a package
2197 usage: osc [global opts] mbranch [-h] [-c] [-a ATTRIBUTE]
2199 [-u UPDATE_ATTRIBUTE] [--dryrun]
2200 [--noaccess]
2201 [--nodevelproject] [--version]
2202 This command is used for searching all relevant instances of packages
2204 and creating links of them in one project. This is esp. used for main‐
2205 tenance updates. It can also be used to branch all packages marked be‐
2206 fore with a given attribute.
2207 [See http://en.opensuse.org/openSUSE:Build_Service_Concept_Maintenance
2209 for information on this topic.]
2210 The branched package will live in
2212 home:USERNAME:branches:ATTRIBUTE:PACKAGE if nothing else specified.
2213 If osc maintained or sm is issued only the relevant instances of a
2215 package will be shown. No branch will be created. This is similar to
2216 osc mbranch --dryrun.
2217 usage:
2219 osc sm [SOURCEPACKAGE] [-a ATTRIBUTE]
2220 osc mbranch [ SOURCEPACKAGE [ TARGETPROJECT ] ]
2221 options:
2223 -c, --checkout
2225 Checkout branched package afterwards ('osc bco' is a
2226 shorthand for this option)
2227 -a ATTRIBUTE, --attribute ATTRIBUTE
2230 Use this attribute to find affected packages (default is
2231 OBS:Maintained)
2232 -u UPDATE_ATTRIBUTE, --update-project-attribute UPDATE_ATTRIBUTE
2235 Use this attribute to find update projects (default is
2236 OBS:UpdateProject)
2237 --dryrun
2240 Just simulate the action and report back the result.
2241 --noaccess
2244 Create a hidden project
2245 --nodevelproject
2248 do not follow a defined devel project (primary project
2249 where a package is developed)
2250 --version
2253 print version of maintained package
2254 osc meta
2257 Show meta information, or edit it
2258 usage: osc [global opts] meta [-h] [-a ATTRIBUTE] [--attribute-de‐
2260 faults]
2261 [--attribute-project] [--blame] [-f] [-F
2262 FILE]
2263 [-r REV] [-m TEXT] [-e] [-c] [-R]
2264 [-s ATTRIBUTE_VALUES] [--add ATTRI‐
2265 BUTE_VALUES]
2266 [--delete]
2267 Show or edit build service metadata of type <prj|pkg|prjconf|user|pat‐
2269 tern>.
2270 This command displays metadata on buildservice objects like projects,
2272 packages, or users. The type of metadata is specified by the word after
2273 "meta", like e.g. "meta prj".
2274 prj denotes metadata of a buildservice project. prjconf denotes the
2276 (build) configuration of a project. pkg denotes metadata of a build‐
2277 service package. user denotes the metadata of a user. group denotes
2278 the metadata of a group. pattern denotes installation patterns defined
2279 for a project.
2280 To list patterns, use 'osc meta pattern PRJ'. An additional argument
2282 will be the pattern file to view or edit.
2283 With the --edit switch, the metadata can be edited. Per default, osc
2285 opens the program specified by the environmental variable EDITOR with a
2286 temporary file. Alternatively, content to be saved can be supplied via
2287 the --file switch. If the argument is '-', input is taken from stdin:
2288 osc meta prjconf home:user | sed ... | osc meta prjconf home:user -F -
2289 For meta prj and prjconf updates optional commit messages can be ap‐
2291 plied with --message.
2292 When trying to edit a non-existing resource, it is created implicitly.
2294 Examples:
2296 osc meta prj PRJ
2297 osc meta pkg PRJ PKG
2298 osc meta pkg PRJ PKG -e
2299 usage:
2301 osc meta <prj|prjconf> [-r|--revision REV] ARGS...
2302 osc meta <prj|pkg|prjconf|user|group|pattern> ARGS...
2303 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message TEXT]
2304 -e|--edit ARGS...
2305 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message TEXT]
2306 -F|--file ARGS...
2307 osc meta pattern --delete PRJ PATTERN
2308 osc meta attribute PRJ [PKG [SUBPACKAGE]] [--attribute ATTRIBUTE]
2309 [--create [--set <value_list>]|--delete|--set <value_list>]
2310 options:
2312 -a ATTRIBUTE, --attribute ATTRIBUTE
2314 affect only a given attribute
2315 --attribute-defaults
2318 include defined attribute defaults
2319 --attribute-project
2322 include project values, if missing in packages
2323 --blame
2326 show author and time of each line
2327 -f, --force
2330 force the save operation, allows one to ignores some er‐
2331 rors like depending repositories. For prj meta only.
2332 -F FILE, --file FILE
2335 read metadata from FILE, instead of opening an editor.
2336 '-' denotes standard input.
2337 -r REV, --revision REV
2340 checkout given revision instead of head revision. For prj
2341 and prjconf meta only
2342 -m TEXT, --message TEXT
2345 specify log message TEXT. For prj and prjconf meta only
2346 -e, --edit
2349 edit metadata
2350 -c, --create
2353 create attribute without values
2354 -R, --remove-linking-repositories
2357 Try to remove also all repositories building against re‐
2358 move ones.
2359 -s ATTRIBUTE_VALUES, --set ATTRIBUTE_VALUES
2362 set attribute values
2363 --add ATTRIBUTE_VALUES
2366 add to the existing attribute values, skip duplicates
2367 --delete
2370 delete a pattern or attribute
2371 osc mkpac
2374 Create a new package under version control
2375 usage: osc [global opts] mkpac [-h]
2377 usage:
2379 osc mkpac new_package
2380 osc mv
2382 Move SOURCE file to DEST and keep it under version control
2383 usage: osc [global opts] mv [-h] [-f] source dest
2385 arguments:
2387 source
2389 dest
2392 options:
2395 -f, --force
2397 forces removal of entire package and its files
2398 osc my
2401 Show waiting work, packages, projects or requests involving yourself
2402 usage: osc [global opts] my [-h] [-b] [-m] [-a] [-U USER]
2404 [--exclude-project EXCLUDE_PROJECT]
2405 [--maintained]
2406 Examples:
2408 # list all open tasks for me
2409 osc my [work]
2410 # list packages where I am bugowner
2411 osc my pkg -b
2412 # list projects where I am maintainer
2413 osc my prj -m
2414 # list request for all my projects and packages
2415 osc my rq
2416 # list requests, excluding project 'foo' and 'bar'
2417 osc my rq --exclude-project foo,bar
2418 # list requests I made
2419 osc my sr
2420 usage:
2422 osc my <TYPE>
2423 where TYPE is one of requests, submitrequests,
2425 projects or packages (rq, sr, prj or pkg)
2426 options:
2428 -b, --bugowner
2430 restrict listing to items where the user is bugowner
2431 -m, --maintainer
2434 restrict listing to items where the user is maintainer
2435 -a, --all
2438 all involvements
2439 -U USER, --user USER
2442 search for USER instead of yourself
2443 --exclude-project EXCLUDE_PROJECT
2446 exclude requests for specified project
2447 --maintained
2450 limit search results to packages with maintained attri‐
2451 bute set.
2452 osc patchinfo
2455 Generate and edit a patchinfo file
2456 usage: osc [global opts] patchinfo [-h] [-f]
2458 A patchinfo file describes the packages for an update and the kind of
2460 problem it solves.
2461 This command either creates a new _patchinfo or updates an existing
2463 one.
2464 Examples:
2466 osc patchinfo
2467 osc patchinfo [PROJECT [PATCH_NAME]]
2468 options:
2470 -f, --force
2472 force generation of new patchinfo file, do not update ex‐
2473 isting one.
2474 osc pdiff
2477 Quick alias to diff the content of a package with its parent
2478 usage: osc [global opts] pdiff [-h] [-p] [-n]
2480 usage:
2482 osc pdiff [--plain|-p] [--nomissing-ok|-n]
2483 osc pdiff [--plain|-p] [--nomissing-ok|-n] PKG
2484 osc pdiff [--plain|-p] [--nomissing-ok|-n] PRJ PKG
2485 options:
2487 -p, --plain
2489 output the diff in plain (not unified) diff format
2490 -n, --nomissingok
2493 fail if the parent package does not exist on the server
2494 osc prdiff (projdiff, projectdiff)
2497 Server-side diff of two projects
2498 usage: osc [global opts] prdiff [-h] [-r] [-e REGEXP] [-i REGEXP] [-n]
2500 [-o]
2501 [-u] [-d]
2502 Compares two projects and either summarizes or outputs the differences
2504 in full. In the second form, a project is compared with one of its
2505 branches inside a home:$USER project (the branch is treated as NEWPRJ).
2506 The home branch is optional if the current working directory is a
2507 checked out copy of it.
2508 usage:
2510 osc prdiff [OPTIONS] OLDPRJ NEWPRJ
2511 osc prdiff [OPTIONS] [home:$USER:branch:$PRJ]
2512 options:
2514 -r, --requests
2516 show open requests for any packages with differences
2517 -e REGEXP, --exclude REGEXP
2520 skip packages matching REGEXP
2521 -i REGEXP, --include REGEXP
2524 only consider packages matching REGEXP
2525 -n, --show-not-in-old
2528 show packages only in the new project
2529 -o, --show-not-in-new
2532 show packages only in the old project
2533 -u, --unified
2536 show full unified diffs of differences
2537 -d, --diffstat
2540 show diffstat of differences
2541 osc prjresults (pr)
2544 Shows project-wide build results
2545 usage: osc [global opts] prjresults [-h] [-b] [-w] [-c] [--xml] [-s
2547 STATUS]
2548 [-n EXPR] [-a ARCH] [-r REPO] [-V]
2549 [--show-excluded]
2550 usage:
2552 osc prjresults (inside working copy)
2553 osc prjresults PROJECT
2554 options:
2556 -b, --brief
2558 show the result in "pkgname repo arch result"
2559 -w, --watch
2562 watch the results until all finished building, only sup‐
2563 ported with --xml
2564 -c, --csv
2567 csv output
2568 --xml generate output in XML
2571 -s STATUS, --status-filter STATUS
2574 show only packages with buildstatus STATUS (see legend)
2575 -n EXPR, --name-filter EXPR
2578 show only packages whose names match EXPR
2579 -a ARCH, --arch ARCH
2582 show results only for specified architecture(s)
2583 -r REPO, --repo REPO
2586 show results only for specified repo(s)
2587 -V, --vertical
2590 list packages vertically instead horizontally
2591 --show-excluded
2594 show packages that are excluded in all repos, also hide
2595 repos that have only excluded packages
2596 osc pull
2599 Merge the changes of the link target into your working copy
2600 usage: osc [global opts] pull [-h]
2602 osc rdelete
2604 Delete a project or packages on the server
2605 usage: osc [global opts] rdelete [-h] [-r] [-f] [-m TEXT]
2607 As a safety measure, project must be empty (i.e., you need to delete
2609 all packages first). Also, packages must have no requests pending
2610 (i.e., you need to accept/revoke such requests first). If you are sure
2611 that you want to remove this project and all its packages use '--recur‐
2612 sive' switch. It may still not work because other depends on it. If
2613 you want to ignore this as well use '--force' switch.
2614 usage:
2616 osc rdelete [-r] [-f] PROJECT [PACKAGE]
2617 options:
2619 -r, --recursive
2621 deletes a project with packages inside
2622 -f, --force
2625 deletes a project where other depends on
2626 -m TEXT, --message TEXT
2629 specify log message TEXT
2630 osc rdiff
2633 Server-side "pretty" diff of two packages
2634 usage: osc [global opts] rdiff [-h] [--issues-only] [-M] [-r N[:M]]
2636 [-p]
2637 [-c rev] [--missingok] [-u] [--xml]
2638 Compares two packages (three or four arguments) or shows the changes of
2640 a specified revision of a package (two arguments)
2641 If no revision is specified the latest revision is used.
2643 usage:
2645 osc rdiff OLDPRJ OLDPAC NEWPRJ [NEWPAC]
2646 osc rdiff PROJECT PACKAGE
2647 osc rdiff PROJECT --meta
2648 options:
2650 --issues-only
2652 show only issues in diff
2653 -M, --meta
2656 diff meta data
2657 -r N[:M], --revision N[:M]
2660 revision id, where N = old revision and M = new revision
2661 -p, --plain
2664 output the diff in plain (not unified) diff format and
2665 show diff of files in archives
2666 -c rev, --change rev
2669 the change made by revision rev (like -r rev-1:rev). If
2670 rev is negative this is like -r rev:rev-1.
2671 --missingok
2674 do not fail if the source or target project/package does
2675 not exist on the server
2676 -u, --unexpand
2679 diff unexpanded version if sources are linked
2680 --xml show diff as xml (only for issues diff)
2683 osc rebuild (rebuildpac)
2686 Trigger package rebuilds
2687 usage: osc [global opts] rebuild [-h] [-a ARCH] [-r REPO] [-f] [-M FLA‐
2689 VOR]
2690 [--all]
2691 Note that it is normally NOT needed to kick off rebuilds like this, be‐
2693 cause they principally happen in a fully automatic way, triggered by
2694 source check-ins. In particular, the order in which packages are built
2695 is handled by the build service.
2696 The arguments REPOSITORY and ARCH can be taken from the first two col‐
2698 umns of the 'osc repos' output.
2699 usage:
2701 osc rebuild [PROJECT [PACKAGE[:FLAVOR] [REPOSITORY [ARCH]]]]
2702 options:
2704 -a ARCH, --arch ARCH
2706 trigger rebuilds for a specific architecture
2707 -r REPO, --repo REPO
2710 trigger rebuilds for a specific repository
2711 -f, --failed
2714 rebuild all failed packages
2715 -M FLAVOR, --multibuild-package FLAVOR
2718 Only work with the specified flavors of a multibuild
2719 package. Globs are resolved according to _multibuild
2720 file from server. Empty string is resolved to a package
2721 without a flavor.
2722 --all Rebuild all packages of entire project
2725 osc release
2728 Release sources and binaries
2729 usage: osc [global opts] release [-h] [-r REPO]
2731 [--target-project TARGETPROJECT]
2732 [--target-repository TARGETREPOSITORY]
2733 [--set-release RELEASETAG] [--no-de‐
2734 lay]
2735 This command is used to transfer sources and binaries without rebuild‐
2737 ing them. It requires defined release targets set to trigger="manual".
2738 usage:
2740 osc release [PROJECT [PACKAGE]]
2741 options:
2743 -r REPO, --repo REPO
2745 Release only binaries from the specified repository
2746 --target-project TARGETPROJECT
2749 Release only to specified project
2750 --target-repository TARGETREPOSITORY
2753 Release only to specified repository
2754 --set-release RELEASETAG
2757 rename binaries during release using this release tag
2758 --no-delay
2761 Don't put the release job in a queue to be run later, but
2762 immediately run it. Thus the next call to osc prjresult
2763 will reflect it. Otherwise there is no way to know if it
2764 is finished or didn't start yet.
2765 osc releaserequest
2768 Create a release request
2769 usage: osc [global opts] releaserequest [-h] [-m TEXT] [-p PKG]
2771 For maintenance incident projects:
2773 This command is used by the maintenance team to start the release
2775 process of a maintenance update. This includes usually testing based
2776 on the defined reviewers of the update project.
2777 [See https://openbuildservice.org/help/manu‐
2779 als/obs-user-guide/cha.obs.maintenance_setup.html
2780 for information on this topic.]
2781 For normal projects:
2783 This command is used to transfer sources and binaries without rebuild‐
2785 ing them. It requires defined release targets set to trigger="manual".
2786 [See https://openbuildservice.org/help/manu‐
2788 als/obs-user-guide/cha.obs.request_and_review_system.html
2789 for information on this topic.]
2790 usage:
2792 osc releaserequest [-p package] [ SOURCEPROJECT ]
2793 options:
2795 -m TEXT, --message TEXT
2797 specify message TEXT
2798 -p PKG, --package PKG
2801 specify packages to release
2802 osc remotebuildlog (remotebuildlogtail, rbuildlogtail, rblt, rbuildlog,
2805 rbl)
2806 Shows the build log of a package
2807 usage: osc [global opts] remotebuildlog [-h] [-l] [--lastsucceeded]
2809 [-M FLAVOR] [-o OFFSET] [-s]
2810 Shows the log file of the build of a package. Can be used to follow the
2812 log while it is being written.
2813 remotebuildlogtail shows just the tail of the log file.
2815 usage:
2817 osc remotebuildlog project package[:flavor] repository arch
2818 or
2819 osc remotebuildlog project/package[:flavor]/repository/arch
2820 or
2821 osc remotebuildlog buildlogurl
2822 options:
2824 -l, --last
2826 Show the last finished log file
2827 --lastsucceeded, --last-succeeded
2830 Show the last succeeded log file
2831 -M FLAVOR, --multibuild-package FLAVOR
2834 Only work with the specified flavor of a multibuild pack‐
2835 age.
2836 -o OFFSET, --offset OFFSET
2839 get log starting or ending from the offset
2840 -s, --strip-time
2843 strip leading build time from the log
2844 osc repairlink
2847 Repair a broken source link
2848 usage: osc [global opts] repairlink [-h] [-d DIR]
2850 This command checks out a package with merged source changes. It uses a
2852 3-way merge to resolve file conflicts. After reviewing/repairing the
2853 merge, use 'osc resolved ...' and 'osc ci' to re-create a working
2854 source link.
2855 usage: * For merging conflicting changes of a checkout package:
2857 osc repairlink
2858 * Check out a package and merge changes:
2860 osc repairlink PROJECT PACKAGE
2861 * Pull conflicting changes from one project into another one:
2863 osc repairlink PROJECT PACKAGE INTO_PROJECT [INTO_PACKAGE]
2864 options:
2866 -d DIR, --destdir DIR
2868 destination directory
2869 osc repairwc
2872 Try to repair an inconsistent working copy
2873 usage: osc [global opts] repairwc [-h] [--force-apiurl]
2875 Examples:
2877 osc repairwc <path>
2878 Note: if <path> is omitted it defaults to '.' (<path> can be a project
2880 or package working copy)
2881 Warning: This command might delete some files in the storedir (.osc).
2883 Please check the state of the wc afterwards (via 'osc status').
2884 options:
2886 --force-apiurl
2888 ask once for an apiurl and force this apiurl for all in‐
2889 consistent projects/packages
2890 osc repositories (platforms, repos)
2893 Shows repositories configured for a project
2894 usage: osc [global opts] repositories [-h]
2896 It skips repositories by default which are disabled for a given pack‐
2898 age.
2899 usage:
2901 osc repos
2902 osc repos [PROJECT] [PACKAGE]
2903 osc repourls
2905 Shows URLs of .repo files
2906 usage: osc [global opts] repourls [-h]
2908 Shows URLs on which to access the project repositories.
2910 usage:
2912 osc repourls [PROJECT]
2913 osc request (review, rq)
2915 Show or modify requests and reviews
2916 usage: osc [global opts] request [-h] [-d] [-S SUPERSEDED_REQUEST] [-u]
2918 [--no-devel] [-m TEXT] [-t TYPE] [-a]
2919 [-f]
2920 [-s STATE] [-D DAYS] [-U USER] [-G
2921 GROUP]
2922 [-P PROJECT] [-p PACKAGE] [-b] [-M]
2923 [-B] [-e]
2924 [-i] [--or-revoke] [--non-interactive]
2925 [--exclude-target-project EXCLUDE_TAR‐
2926 GET_PROJECT]
2927 [--keep-packages-locked] [--incoming]
2928 [--involved-projects]
2929 [--target-package-filter TARGET_PACK‐
2930 AGE_FILTER]
2931 [--source-buildstatus]
2932 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
2934 information on this topic.]
2935 The 'request' command has the following sub commands:
2937 "list" lists open requests attached to a project or package or person.
2939 Uses the project/package of the current directory if none of -M, -U
2940 USER, project/package are given.
2941 "log" will show the history of the given ID
2943 "show" will show the request itself, and generate a diff for review, if
2945 used with the --diff option. The keyword show can be omitted if the ID
2946 is numeric.
2947 "decline" will change the request state to "declined"
2949 "reopen" will set the request back to new or review.
2951 "setincident" will direct "maintenance" requests into specific inci‐
2953 dents
2954 "supersede" will supersede one request with another existing one.
2956 "revoke" will set the request state to "revoked" WARNING: Revoking a
2958 maitenance release request unlocks packages in the source project.
2959 To avoid unlocking, use the --keep-packages-locked option.
2960 "accept" will change the request state to "accepted" and will trigger
2962 the actual submit process. That would normally be a server-side copy of
2963 the source package to the target package.
2964 "approve" marks a requests in "review" state as approved. This request
2966 will get accepted automatically when the last review got accepted.
2967 "checkout" will checkout the request's source package ("submit" re‐
2969 quests only).
2970 "prioritize" change the priority of a request to either "critical",
2972 "important", "moderate" or "low"
2973 The 'review' command has the following sub commands:
2976 "list" lists open requests that need to be reviewed by the specified
2978 user or group
2979 "add" adds a person or group as reviewer to a request
2981 "accept" mark the review positive
2983 "decline" mark the review negative. A negative review will decline the
2985 request.
2986 usage:
2988 osc request list [-M] [-U USER] [-s state] [-D DAYS] [-t type] [-B]
2989 [PRJ [PKG]]
2990 osc request log ID
2991 osc request [show] [-d] [-b] ID
2992 osc request accept [-m TEXT] ID
2994 osc request approve [-m TEXT] ID
2995 osc request cancelapproval [-m TEXT] ID
2996 osc request decline [-m TEXT] ID
2997 osc request revoke [-m TEXT] ID
2998 osc request reopen [-m TEXT] ID
2999 osc request setincident [-m TEXT] ID INCIDENT
3000 osc request supersede [-m TEXT] ID SUPERSEDING_ID
3001 osc request approvenew [-m TEXT] PROJECT
3002 osc request prioritize [-m TEXT] ID PRIORITY
3003 osc request checkout/co ID
3005 osc request clone [-m TEXT] ID
3006 osc review show [-d] [-b] ID
3008 osc review list [-U USER] [-G GROUP] [-P PROJECT [-p PACKAGE]] [-s
3009 state]
3010 osc review add [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p PACK‐
3011 AGE]] ID
3012 osc review accept [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
3013 PACKAGE]] ID
3014 osc review decline [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
3015 PACKAGE]] ID
3016 osc review reopen [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
3017 PACKAGE]] ID
3018 osc review supersede [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT [-p
3019 PACKAGE]] ID SUPERSEDING_ID
3020 options:
3022 -d, --diff
3024 generate a diff
3025 -S SUPERSEDED_REQUEST, --superseded-request SUPERSEDED_REQUEST
3028 Create the diff relative to a given former request
3029 -u, --unified
3032 output the diff in the unified diff format
3033 --no-devel
3036 Do not attempt to forward to devel project
3037 -m TEXT, --message TEXT
3040 specify message TEXT
3041 -t TYPE, --type TYPE
3044 limit to requests which contain a given action type (sub‐
3045 mit/delete/change_devel/add_role/set_bugowner/mainte‐
3046 nance_incident/maintenance_release)
3047 -a, --all
3050 all states. Same as'-s all'
3051 -f, --force
3054 enforce state change, can be used to ignore open reviews,
3055 devel-package dependencies and more
3056 -s STATE, --state STATE
3059 only list requests in one of the comma separated given
3060 states (new/review/accepted/revoked/declined) or "all"
3061 [default="new,review,declined"]
3062 -D DAYS, --days DAYS
3065 only list requests in state "new" or changed in the last
3066 DAYS.
3067 -U USER, --user USER
3070 requests or reviews limited for the specified USER
3071 -G GROUP, --group GROUP
3074 requests or reviews limited for the specified GROUP
3075 -P PROJECT, --project PROJECT
3078 requests or reviews limited for the specified PROJECT
3079 -p PACKAGE, --package PACKAGE
3082 requests or reviews limited for the specified PACKAGE,
3083 requires also a PROJECT
3084 -b, --brief
3087 print output in list view as list subcommand
3088 -M, --mine
3091 only show requests created by yourself
3092 -B, --bugowner
3095 also show requests about packages where I am bugowner
3096 -e, --edit
3099 edit a submit action
3100 -i, --interactive
3103 interactive review of request
3104 --or-revoke
3107 For automation scripts: accepts (if using with accept ar‐
3108 gument) a request when it is in new or review state. Or
3109 revoke it when it got declined. Otherwise just do noth‐
3110 ing.
3111 --non-interactive
3114 non-interactive review of request
3115 --exclude-target-project EXCLUDE_TARGET_PROJECT
3118 exclude target project from request list
3119 --keep-packages-locked
3122 Avoid unlocking of packages in maintenance incident when
3123 revoking release requests
3124 --incoming
3127 Show only requests where the project is target
3128 --involved-projects
3131 show all requests for project/packages where USER is in‐
3132 volved
3133 --target-package-filter TARGET_PACKAGE_FILTER
3136 only list requests for the packages matching the package
3137 filter. A (python) regular expression is expected.
3138 --source-buildstatus
3141 print the buildstatus of the source package (only works
3142 with "show" and the interactive review)
3143 osc requestmaintainership (reqbs, reqms, reqmaintainership, requestbugown‐
3146 ership, reqbugownership)
3147 Requests to add user as maintainer or bugowner
3148 usage: osc [global opts] requestmaintainership [-h] [-m TEXT] [-r role]
3150 usage:
3152 osc requestmaintainership # for current
3153 user in checked out package
3154 osc requestmaintainership USER # for speci‐
3155 fied user in checked out package
3156 osc requestmaintainership PROJECT # for current
3157 user if cwd is not a checked out package
3158 osc requestmaintainership PROJECT group:NAME # request for
3159 specified group
3160 osc requestmaintainership PROJECT PACKAGE # for current
3161 user
3162 osc requestmaintainership PROJECT PACKAGE USER # request for
3163 specified user
3164 osc requestmaintainership PROJECT PACKAGE group:NAME # request for
3165 specified group
3166 osc requestbugownership ... # accepts same
3168 parameters but uses bugowner role
3169 options:
3171 -m TEXT, --message TEXT
3173 specify message TEXT
3174 -r role, --role role
3177 specify user role (default: maintainer)
3178 osc resolved
3181 Remove 'conflicted' state on working copy files
3182 usage: osc [global opts] resolved [-h]
3184 If an upstream change can't be merged automatically, a file is put into
3186 in 'conflicted' ('C') state. Within the file, conflicts are marked with
3187 special <<<<<<< as well as ======== and >>>>>>> lines.
3188 After manually resolving all conflicting parts, use this command to re‐
3190 move the 'conflicted' state.
3191 Note: this subcommand does not semantically resolve conflicts or re‐
3193 move conflict markers; it merely removes the conflict-related artifact
3194 files and allows PATH to be committed again.
3195 usage:
3197 osc resolved FILE [FILE...]
3198 osc restartbuild (abortbuild)
3200 Restart the build of a certain project or package
3201 usage: osc [global opts] restartbuild [-h] [-a ARCH] [-M FLAVOR] [-r
3203 REPO]
3204 [--all]
3205 usage:
3207 osc restartbuild [PROJECT [PACKAGE[:FLAVOR] [REPOSITORY [ARCH]]]]
3208 options:
3210 -a ARCH, --arch ARCH
3212 Restart builds for a specific architecture
3213 -M FLAVOR, --multibuild-package FLAVOR
3216 Only work with the specified flavors of a multibuild
3217 package. Globs are resolved according to _multibuild
3218 file from server. Empty string is resolved to a package
3219 without a flavor.
3220 -r REPO, --repo REPO
3223 Restart builds for a specific repository
3224 --all Restart all running builds of entire project
3227 osc results (r)
3230 Shows the build results of a package or project
3231 usage: osc [global opts] results [-h] [-l] [-r REPO] [-a ARCH] [-b]
3233 [--no-multibuild] [-M FLAVOR] [-V]
3234 [-w]
3235 [-s STATUS_FILTER] [-f] [--xml]
3236 [--csv]
3237 [--format FORMAT] [--show-excluded]
3238 usage:
3240 osc results # (inside working copy of PRJ or PKG)
3241 osc results PROJECT [PACKAGE[:FLAVOR]]
3242 options:
3244 -l, --last-build
3246 show last build results (succeeded/failed/unknown)
3247 -r REPO, --repo REPO
3250 Show results only for specified repo(s)
3251 -a ARCH, --arch ARCH
3254 Show results only for specified architecture(s)
3255 -b, --brief
3258 show the result in "pkgname repo arch result". Default
3259 for -f
3260 --no-multibuild
3263 Disable results for all direct affect packages inside of
3264 the project
3265 -M FLAVOR, --multibuild-package FLAVOR
3268 Only work with the specified flavors of a multibuild
3269 package. Globs are resolved according to _multibuild
3270 file from server. Empty string is resolved to a package
3271 without a flavor.
3272 -V, --vertical
3275 list packages vertically instead horizontally for entire
3276 project
3277 -w, --watch
3280 watch the results until all finished building
3281 -s STATUS_FILTER, --status-filter STATUS_FILTER
3284 only show packages with the given build status
3285 -f, --failed
3288 show only failed results
3289 --xml generate output in XML (former results_meta)
3292 --csv generate output in CSV format
3295 --format FORMAT
3298 format string for csv output
3299 --show-excluded
3302 show repos that are excluded for this package
3303 osc revert
3306 Restore changed files or the entire working copy
3307 usage: osc [global opts] revert [-h] file [file ...]
3309 Examples:
3311 osc revert <modified file(s)>
3312 osc revert . Note: this only works for package working copies
3313 arguments:
3315 file
3317 osc rpmlintlog (lint, rpmlint)
3320 Shows the rpmlint logfile
3321 usage: osc [global opts] rpmlintlog [-h]
3323 Shows the rpmlint logfile to analyse if there are any problems with the
3325 spec file and the built binaries.
3326 usage:
3328 osc rpmlintlog project package repository arch
3329 osc rremove
3331 Remove source files from selected package
3332 usage: osc [global opts] rremove [-h] [-f] project package file [file
3334 ...]
3335 arguments:
3337 project
3339 package
3342 file
3345 options:
3348 -f, --force
3350 Don't ask and delete files
3351 osc search (bse, se)
3354 Search for a project and/or package
3355 usage: osc [global opts] search [-h] [--repos-baseurl] [-e] [-s]
3357 [--package]
3358 [--project] [--title] [--description]
3359 [-a ATTRIBUTE] [-V] [-i] [-b] [-m] [-M]
3360 [--csv] [--binary] [-B PROJECT]
3361 [--binaryversion VERSION]
3362 If no option is specified osc will search for projects and packages
3364 which contains the 'search term' in their name, title or description.
3365 usage:
3367 osc search 'search term' <options>
3368 osc bse ... ('osc search --binary')
3369 osc se 'perl(Foo::Bar)' ('osc search --package
3370 perl-Foo-Bar')
3371 options:
3373 --repos-baseurl
3375 show base URLs of download repositories
3376 -e, --exact
3379 show only exact matches, this is default now
3380 -s, --substring
3383 Show also results where the search term is a sub string,
3384 slower search
3385 --package
3388 search for a package
3389 --project
3392 search for a project
3393 --title
3396 search for matches in the 'title' element
3397 --description
3400 search for matches in the 'description' element
3401 -a ATTRIBUTE, --limit-to-attribute ATTRIBUTE
3404 match only when given attribute exists in meta data
3405 -V, --version
3408 show package version, revision, and srcmd5. CAUTION: This
3409 is slow and unreliable
3410 -i, --involved
3413 show projects/packages where given person (or myself) is
3414 involved as bugowner or maintainer [[{group|per‐
3415 son}/]<name>] default: person
3416 -b, --bugowner
3419 as -i, but only bugowner
3420 -m, --maintainer
3423 as -i, but only maintainer
3424 -M, --mine
3427 shorthand for --bugowner --package
3428 --csv generate output in CSV (separated by |)
3431 --binary
3434 search binary packages
3435 -B PROJECT, --baseproject PROJECT
3438 search packages built for PROJECT (implies --binary)
3439 --binaryversion VERSION
3442 search for binary with specified version (implies --bi‐
3443 nary)
3444 osc sendsysrq
3447 Trigger a sysrq in a running build
3448 usage: osc [global opts] sendsysrq [-h] [-M FLAVOR]
3450 This is only going to work when the build is running in a supported VM.
3452 Also only a subset of sysrq are supported. Typical use case for debug‐
3453 ging are 9, t and w in this sequence.
3454 usage:
3456 osc sendsysrq REPOSITORY ARCH SYSRQ
3457 osc sendsysrq PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH SYSRQ
3458 options:
3460 -M FLAVOR, --multibuild-package FLAVOR
3462 Only work with the specified flavors of a multibuild
3463 package. Globs are resolved according to _multibuild
3464 file from server. Empty string is resolved to a package
3465 without a flavor.
3466 osc service
3469 Handle source services
3470 usage: osc [global opts] service [-h] [-v]
3472 Source services can be used to modify sources like downloading files,
3474 verify files, generating files or modify existing files.
3475 usage:
3477 osc service COMMAND (inside working copy)
3478 osc service run [SOURCE_SERVICE]
3479 osc service runall
3480 osc service manualrun [SOURCE_SERVICE]
3481 osc service remoterun [PROJECT PACKAGE]
3482 osc service merge [PROJECT PACKAGE]
3483 osc service wait [PROJECT PACKAGE]
3484 COMMAND can be:
3486 run r run defined services with modes "trylocal",
3487 "localonly", or no mode set locally,
3488 may take an optional parameter to run only a speci‐
3489 fied source service. In case
3490 parameters exist for this one in _service file they
3491 are used.
3492 runall ra run all services independent of the used mode
3493 manualrun mr run all services with mode "manual", may take an op‐
3494 tional parameter to run only a
3495 specified source service
3496 remoterun rr trigger a re-run on the server side
3497 merge commits all server side generated files and drops
3498 the _service definition
3499 wait waits until the service finishes and returns with an
3500 error if it failed
3501 Not for common usage anymore:
3503 localrun lr the same as "run" but services with mode
3504 "serveronly" are also executed
3505 disabledrun dr run all services with mode "disabled"
3506 options:
3508 -v, --verbose
3510 verbose run of local services for debugging purposes
3511 osc setdevelproject (sdp)
3514 Set the devel project / package of a package
3515 usage: osc [global opts] setdevelproject [-h] [-u]
3517 Examples:
3519 osc setdevelproject [PROJECT PACKAGE] DEVEL_PROJECT [DEVEL_PACKAGE]
3520 options:
3522 -u, --unset
3524 remove devel project
3525 osc setlinkrev
3528 Updates a revision number in a source link
3529 usage: osc [global opts] setlinkrev [-h] [-r rev] [-R] [-u]
3531 This command adds or updates a specified revision number in a source
3533 link. The current revision of the source is used, if no revision num‐
3534 ber is specified.
3535 usage:
3537 osc setlinkrev
3538 osc setlinkrev PROJECT [PACKAGE]
3539 options:
3541 -r rev, --revision rev
3543 use the specified revision.
3544 -R, --use-plain-revision
3547 Do not expand revision the specified or latest rev
3548 -u, --unset
3551 remove revision in link, it will point always to latest
3552 revision
3553 osc showlinked
3556 Show all packages linking to a given one
3557 usage: osc [global opts] showlinked [-h]
3559 Examples:
3561 osc showlinked [PROJECT PACKAGE]
3562 osc signkey
3564 Manage Project Signing Key
3565 usage: osc [global opts] signkey [-h] [--create] [--extend] [--delete]
3567 [--notraverse] [--sslcert]
3568 osc signkey [--create|--delete|--extend] <PROJECT> osc signkey [--no‐
3570 traverse] <PROJECT>
3571 This command is for managing gpg keys. It shows the public key by de‐
3573 fault. There is no way to download or upload the private part of a key
3574 by design.
3575 However you can create a new own key. You may want to consider to sign
3577 the public key with your own existing key.
3578 If a project has no key, the key from upper level project will be used
3580 (e.g. when dropping "KDE:KDE4:Community" key, the one from "KDE:KDE4"
3581 will be used).
3582 WARNING: THE OLD KEY CANNOT BE RESTORED AFTER USING DELETE OR CREATE
3584 options:
3586 --create
3588 create new gpg signing key for this project
3589 --extend
3592 extend expiration date of the gpg public key for this
3593 project
3594 --delete
3597 delete the gpg signing key in this project
3598 --notraverse
3601 don't traverse projects upwards to find key
3602 --sslcert
3605 fetch SSL certificate instead of GPG key
3606 osc status (st)
3609 Show status of files in working copy
3610 usage: osc [global opts] status [-h] [-e]
3612 Show the status of files in a local working copy, indicating whether
3614 files have been changed locally, deleted, added, ...
3615 The first column in the output specifies the status and is one of the
3617 following characters:
3618 ' ' no modifications
3619 'A' Added
3620 'C' Conflicted
3621 'D' Deleted
3622 'M' Modified
3623 'R' Replaced (file was deleted and added again afterwards)
3624 '?' item is not under version control
3625 '!' item is missing (removed by non-osc command) or incomplete
3626 'S' item is skipped (item exceeds a file size limit or is _service:*
3627 file)
3628 'F' Frozen (use "osc pull" to merge conflicts) (package-only state)
3629 examples:
3631 osc st
3632 osc st <directory>
3633 osc st file1 file2 ...
3634 usage:
3636 osc status [OPTS] [PATH...]
3637 options:
3639 -e, --show-excluded
3641 also show files which are excluded by the "exclude_glob"
3642 config option
3643 osc submitrequest (submitpac, submitreq, sr)
3646 Create request to submit source into another Project
3647 usage: osc [global opts] submitrequest [-h] [-m TEXT] [-F FILE] [-r
3649 REV]
3650 [-s REQUEST_ID] [--nodevelpro‐
3651 ject]
3652 [--separate-requests]
3653 [--cleanup]
3654 [--no-cleanup] [--no-update]
3655 [--update-link] [-d] [--yes]
3656 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration for
3658 information on this topic.]
3659 See the "request" command for showing and modifying existing requests.
3661 usage:
3663 osc submitreq [OPTIONS]
3664 osc submitreq [OPTIONS] DESTPRJ [DESTPKG]
3665 osc submitreq [OPTIONS] SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
3666 osc submitpac ... is a shorthand for osc submitreq --cleanup ...
3668 options:
3670 -m TEXT, --message TEXT
3672 specify message TEXT
3673 -F FILE, --file FILE
3676 read log message from FILE, '-' denotes standard input.
3677 -r REV, --revision REV
3680 specify a certain source revision ID (the md5 sum) for
3681 the source package
3682 -s REQUEST_ID, --supersede REQUEST_ID
3685 Superseding another request by this one
3686 --nodevelproject
3689 do not follow a defined devel project (primary project
3690 where a package is developed)
3691 --separate-requests
3694 Create multiple requests instead of a single one (when
3695 command is used for entire project)
3696 --cleanup
3699 remove package if submission gets accepted (default for
3700 home:<id>:branch projects)
3701 --no-cleanup
3704 never remove source package on accept, but update its
3705 content
3706 --no-update
3709 never touch source package on accept (will break source
3710 links)
3711 --update-link
3714 This transfers the source including the _link file.
3715 -d, --diff
3718 show diff only instead of creating the actual request
3719 --yes proceed without asking.
3722 osc token
3725 Show and manage authentication token
3726 usage: osc [global opts] token [-h] [-c] [-d TOKENID] [-o OPERATION]
3728 [-t TOKENSTRING] [--scm-token SCM_TOKEN]
3729 Authentication token can be used to run specific commands without send‐
3731 ing credentials.
3732 usage:
3734 osc token
3735 osc token --create [--operation <OPERATION>] [<PROJECT> <PACKAGE>]
3736 osc token --delete <TOKENID>
3737 osc token --trigger <TOKENSTRING> [--operation <OPERATION>]
3738 [<PROJECT> <PACKAGE>]
3739 options:
3741 -c, --create
3743 Create a new token
3744 -d TOKENID, --delete TOKENID
3747 Delete a token
3748 -o OPERATION, --operation OPERATION
3751 Default is "runservice", but "branch", "release", "re‐
3752 build", or "workflow" can also be used
3753 -t TOKENSTRING, --trigger TOKENSTRING
3756 Trigger the action of a token
3757 --scm-token SCM_TOKEN
3760 The scm's access token (only in combination with a --op‐
3761 eration=workflow option)
3762 osc triggerreason (tr)
3765 Show reason why a package got triggered to build
3766 usage: osc [global opts] triggerreason [-h] [-M FLAVOR]
3768 The server decides when a package needs to get rebuild, this command
3770 shows the detailed reason for a package. A brief reason is also stored
3771 in the jobhistory, which can be accessed via "osc jobhistory".
3772 Trigger reasons might be:
3774 - new build (never build yet or rebuild manually forced)
3775 - source change (e.g. on updating sources)
3776 - meta change (packages which are used for building have changed)
3777 - rebuild count sync (In case that it is configured to sync release
3778 numbers)
3779 usage in package or project directory:
3781 osc triggerreason REPOSITORY ARCH
3782 osc triggerreason PROJECT PACKAGE[:FLAVOR] REPOSITORY ARCH
3783 options:
3785 -M FLAVOR, --multibuild-package FLAVOR
3787 Only work with the specified flavor of a multibuild pack‐
3788 age.
3789 osc undelete
3792 Restores a deleted project or package on the server
3793 usage: osc [global opts] undelete [-h] [-m TEXT]
3795 The server restores a package including the sources and meta configura‐
3797 tion. Binaries remain to be lost and will be rebuild.
3798 usage:
3800 osc undelete PROJECT
3801 osc undelete PROJECT PACKAGE
3802 options:
3804 -m TEXT, --message TEXT
3806 specify log message TEXT
3807 osc unlock
3810 Unlocks a project or package
3811 usage: osc [global opts] unlock [-h] [-m TEXT]
3813 Unlocks a locked project or package. A comment is required.
3815 usage:
3817 osc unlock PROJECT [PACKAGE]
3818 options:
3820 -m TEXT, --message TEXT
3822 specify log message TEXT
3823 osc update (up)
3826 Update a working copy
3827 usage: osc [global opts] update [-h] [-r REV] [--linkrev REV] [-u] [-e]
3829 [-s]
3830 [-S] [-l limit_size]
3831 examples:
3833 1. osc up
3835 If the current working directory is a package, update it.
3836 If the directory is a project directory, update all contained
3837 packages, AND check out newly added packages.
3838 To update only checked out packages, without checking out new
3840 ones, you might want to use "osc up *" from within the project
3841 dir.
3842 2. osc up PAC
3844 Update the packages specified by the path argument(s)
3845 When --expand-link is used with source link packages, the expanded
3847 sources will be checked out. Without this option, the _link file and
3848 patches will be checked out. The option --unexpand-link can be used to
3849 switch back to the "raw" source with a _link file plus patch(es).
3850 options:
3852 -r REV, --revision REV
3854 update to specified revision (this option will be ignored
3855 if you are going to update the complete project or more
3856 than one package)
3857 --linkrev REV
3860 revision of the link target that is used during link ex‐
3861 pansion
3862 -u, --unexpand-link
3865 if a package is an expanded link, update to the raw _link
3866 file
3867 -e, --expand-link
3870 if a package is a link, update to the expanded sources
3871 -s, --source-service-files
3874 Run local source services after update.
3875 -S, --server-side-source-service-files
3878 Use server side generated sources instead of local gener‐
3879 ation.
3880 -l limit_size, --limit-size limit_size
3883 Skip all files with a given size
3884 osc updatepacmetafromspec (updatepkgmetafromspec, metafromspec)
3887 Update package meta information from a specfile
3888 usage: osc [global opts] updatepacmetafromspec [-h] [--specfile FILE]
3890 ARG, if specified, is a package working copy.
3892 options:
3894 --specfile FILE
3896 Path to specfile. (if you pass more than working copy
3897 this option is ignored)
3898 osc vc
3901 Edit the changes file
3902 usage: osc [global opts] vc [-h] [-m MESSAGE] [-F FILE] [-e]
3904 osc vc [-m MESSAGE|-e] [filename[.changes]|path [file_with_comment]] If
3906 no <filename> is given, exactly one *.changes or *.spec file has to be
3907 in the cwd or in path.
3908 The email address used in .changes file is read from BuildService in‐
3910 stance, or should be defined in oscrc [https://api.opensuse.org/] user
3911 = login pass = password email = user@defined.email
3912 or can be specified via mailaddr environment variable.
3914 By default, osc vc opens the program specified by the EDITOR environ‐
3916 ment variable (and it uses Vim if that variable is not set) with a tem‐
3917 porary file that should replace the *.changes file when saved by the
3918 editor, or discarded otherwise.
3919 options:
3921 -m MESSAGE, --message MESSAGE
3923 add MESSAGE to changes (do not open an editor)
3924 -F FILE, --file FILE
3927 read changes message from FILE (do not open an editor)
3928 -e, --just-edit
3931 just open changes (cannot be used with -m)
3932 osc version
3935 Give version of osc binary
3936 usage: osc [global opts] version [-h]
3938 usage:
3940 osc version
3941 osc whatdependson
3943 Show the packages that require the specified package during the build
3944 usage: osc [global opts] whatdependson [-h]
3946 The command whatdependson can be used to find out what will be trig‐
3948 gered when a certain package changes.
3949 This is no guarantee, since the new build might have changed dependen‐
3951 cies.
3952 The packages marked with the [i] flag are inherited to the project.
3954 The arguments REPOSITORY and ARCH can be taken from the first two col‐
3956 umns of the 'osc repos' output.
3957 usage in package or project directory:
3959 osc whatdependson REPOSITORY ARCH
3960 usage:
3962 osc whatdependson PROJECT [PACKAGE] REPOSITORY ARCH
3963 osc whois (user, who)
3965 Show fullname and email of a buildservice user
3966 usage: osc [global opts] whois [-h] [user ...]
3968 arguments:
3970 user
3972 osc wipebinaries (unpublish)
3975 Delete all binary packages of a certain project/package
3976 usage: osc [global opts] wipebinaries [-h] [-a ARCH] [-M FLAVOR] [-r
3978 REPO]
3979 [--build-disabled]
3980 [--build-failed]
3981 [--broken] [--unresolvable]
3982 [--all]
3983 With the optional argument <package> you can specify a certain package
3985 otherwise all binary packages in the project will be deleted.
3986 usage:
3988 osc wipebinaries OPTS # works in checked out
3989 project dir
3990 osc wipebinaries OPTS PROJECT [PACKAGE[:FLAVOR]]
3991 osc unpublish OPTS # works in checked out
3992 project dir
3993 osc unpublish OPTS PROJECT [PACKAGE[:FLAVOR]]
3994 options:
3996 -a ARCH, --arch ARCH
3998 Delete all binary packages for a specific architecture
3999 -M FLAVOR, --multibuild-package FLAVOR
4002 Only work with the specified flavors of a multibuild
4003 package. Globs are resolved according to _multibuild
4004 file from server. Empty string is resolved to a package
4005 without a flavor.
4006 -r REPO, --repo REPO
4009 Delete all binary packages for a specific repository
4010 --build-disabled
4013 Delete all binaries of packages for which the build is
4014 disabled
4015 --build-failed
4018 Delete all binaries of packages for which the build
4019 failed
4020 --broken
4023 Delete all binaries of packages for which the package
4024 source is bad
4025 --unresolvable
4028 Delete all binaries of packages which have dependency er‐
4029 rors
4030 --all Delete all binaries regardless of the package status
4033 (previously default)
4034 osc workerinfo
4037 Gets the information to a worker from the server
4038 usage: osc [global opts] workerinfo [-h] <hostarch>:<workerid>
4040 Examples:
4042 osc workerinfo x86_64:goat:1
4043 usage:
4045 osc workerinfo <hostarch>:<workerid>
4046 arguments:
4048 <hostarch>:<workerid>
4050
4054 Contributors to the osc project. See the project's GIT history for the complete list.
4055
4058 The latest version of osc may be downloaded from
4059 ⟨https://github.com/openSUSE/osc/⟩
4060osc 2023-12-07 OSC(1)