1OSC(1) User Commands OSC(1)
2
6 osc - openSUSE build service command-line tool.
7
9 osc [GLOBALOPTS] SUBCOMMAND [OPTS] [ARGS...]
10 osc help SUBCOMMAND
11
13 openSUSE build service command-line tool.
14 COMMANDS
17 add Mark files to be added upon the next commit
18 In case a URL is given the file will get downloaded and regis‐
20 tered to be downloaded by the server as well via the down‐
21 load_url source service.
22 This is recommended for release tar balls to track their source
24 and to help others to review your changes esp. on version
25 upgrades.
26 usage:
28 osc add URL [URL...]
29 osc add FILE [FILE...]
30 addchannels
33 Add channels to project.
34 The command adds all channels which are defined to be used for a
36 given source package. The source link target is used to lookup
37 the channels. The command can be used for a certain package or
38 for all in the specified project.
39 In case no channel is defined the operation is just returning.
41 Examples:
43 osc addchannels [PROJECT [PACKAGE]] Options:
44 -h, --help show this help message and exit
45 -e, --enable-all
46 Enable all added channels including the ones
47 disabled
48 by default.
49 -s, --skip-disabled
50 Skip disabled channels. Otherwise the source
51 gets
52 added, but not the repositories.
53 addcontainers
57 Add maintained containers for a give package
58 The command adds all containers which are marked as maintained
60 and contain an rpm originating from the specified source pack‐
61 age.
62 Examples:
64 osc addcontainers [PROJECT PACKAGE] Options:
65 -h, --help show this help message and exit
66 --extend-package-names
67 Extend packages names with project name as suf‐
68 fix
69 addremove (ar)
73 Adds new files, removes disappeared files
74 Adds all files new in the local copy, and removes all disap‐
76 peared files.
77 ARG, if specified, is a package working copy.
79 Usage:
81 osc addremove [ARGS...]
82 Options:
84 -h, --help show this help message and exit
85 -r, --recursive
86 If CWD is a project dir then scan all package
87 dirs as
88 well
89 aggregatepac
93 "Aggregate" a package to another package
94 Aggregation of a package means that the build results (binaries)
96 of a package are basically copied into another project. This
97 can be used to make packages available from building that are
98 needed in a project but available only in a different project.
99 Note that this is done at the expense of disk space. See
100 http://en.opensuse.org/openSUSE:Build_Ser‐
101 vice_Tips_and_Tricks#link_and_aggregate for more information.
102 The DESTPAC name is optional; the source packages' name will be
104 used if DESTPAC is omitted.
105 usage:
107 osc aggregatepac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC]
108 Options:
109 -h, --help show this help message and exit
110 -d, --disable-publish
111 disable publishing of the aggregated package
112 -m SRC=TARGET[,SRC=TARGET], --map-repo=SRC=TARGET[,SRC=TAR‐
113 GET]
114 Allows repository mapping(s) to be given as
115 SRC=TARGET[,SRC=TARGET]
116 --nosources
117 ignore source packages when copying build
118 results to
119 destination project
120 api Issue an arbitrary request to the API
124 Useful for testing.
126 URL can be specified either partially (only the path component),
128 or fully with URL scheme and hostname ('http://...').
129 Note the global -A and -H options (see osc help).
131 Examples:
133 osc api /source/home:user
134 osc api -X PUT -T /etc/fstab source/home:user/test5/myfstab
135 osc api -e /configuration
136 Usage:
138 osc api URL
139 Options:
141 -h, --help show this help message and exit
142 -a NAME STRING, --add-header=NAME STRING
143 add the specified header to the request
144 -T FILE, -f FILE, --file=FILE
145 specify filename to upload, uses PUT mode by
146 default
147 -d STRING, --data=STRING
148 specify string data for e.g. POST
149 -e, --edit GET, edit and PUT the location
150 -X HTTP_METHOD, -m HTTP_METHOD, --method=HTTP_METHOD
151 specify HTTP method to use (GET|PUT|DELETE|POST)
152 branch (bco, branchco, getpac)
156 Branch a package
157 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
159 for information on this topic.]
160 Create a source link from a package of an existing project to a
162 new subproject of the requesters home project (home:branches:)
163 The branched package will live in
165 home:USERNAME:branches:PROJECT/PACKAGE if nothing else spec‐
166 ified.
167 With getpac or bco, the branched package will come from one of
169 openSUSE:Factory (list of projects from oscrc:get‐
170 pac_default_project) if nothing else is specfied on the command
171 line.
172 In case of branch errors, where the source has currently merge
174 conflicts use --linkrev=base option.
175 usage:
177 osc branch
178 osc branch SOURCEPROJECT SOURCEPACKAGE
179 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT
180 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT TARGET‐
181 PACKAGE
182 osc getpac SOURCEPACKAGE
183 osc bco ... Options:
184 -h, --help show this help message and exit
185 --add-repositories-rebuild=add_repositories_rebuild
186 specify the used rebuild strategy for new repos‐
187 itories
188 --add-repositories-block=add_repositories_block
189 specify the used block strategy for new reposi‐
190 tories
191 --linkrev=linkrev
192 specify the used revision in the link target.
193 -r rev, --revision=rev
194 branch against a specific revision
195 -N, --new-package
196 create a branch pointing to a not yet existing
197 package
198 -M, --maintenance
199 Create project and package in maintenance mode
200 -m TEXT, --message=TEXT
201 specify message TEXT
202 --noaccess Create a hidden project
203 --extend-package-names
204 Extend packages names with project name as suf‐
205 fix
206 --add-repositories
207 Add repositories to target project (happens by
208 default
209 when project is new)
210 -f, --force
211 force branch, overwrite target
212 -c, --checkout
213 Checkout branched package afterwards using "co
214 -e
215 -S"('osc bco' is a shorthand for this option)
216 --nodevelproject
217 do not follow a defined devel project (primary
218 project
219 where a package is developed)
220 browse opens browser
224 usage:
226 osc browse [PROJECT [PACKAGE]]
227 build (chroot, shell, wipe)
231 Build a package on your local machine
232 You need to call the command inside a package directory, which
234 should be a buildsystem checkout. (Local modifications are
235 fine.)
236 The arguments REPOSITORY and ARCH can be taken from the first
238 two columns of the 'osc repos' output. BUILD_DESCR is either a
239 RPM spec file, or a Debian dsc file.
240 The command honors packagecachedir, build-root and build-uid
242 settings in oscrc, if present. You may want to set su-wrapper =
243 'sudo' in oscrc, and configure sudo with option NOPASSWD for
244 /usr/bin/build.
245 If neither --clean nor --noinit is given, build will reuse an
247 existing build-root again, removing unneeded packages and add
248 missing ones. This is usually the fastest option.
249 If the package doesn't exist on the server please use the
251 --local-package option. If the project of the package doesn't
252 exist on the server please use the --alternative-project <alter‐
253 native-project> option: Example:
254 osc build [OPTS] --alternative-project openSUSE:10.3 stan‐
255 dard i586 BUILD_DESCR
256 usage:
258 osc build [OPTS] # will try to guess a
259 build environement
260 osc build [OPTS] REPOSITORY ARCH BUILD_DESCR
261 osc build [OPTS] REPOSITORY ARCH
262 osc build [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR is
263 detected automatically)
264 osc build [OPTS] ARCH (REPOSITORY = build_repository (config
265 option), BUILD_DESCR is detected automatically)
266 osc build [OPTS] BUILD_DESCR (REPOSITORY = build_repository
267 (config option), ARCH = hostarch)
268 osc build [OPTS] (REPOSITORY = build_repository (config
269 option), ARCH = hostarch, BUILD_DESCR is detected automatically)
270 For debugging purposes you can run after a build the following
272 to jump inside of of the build environemnt:
273 osc shell [OPTS] REPOSITORY ARCH
275 Run a single command inside of the build environment:
277 osc shell --shell-cmd=COMMAND [OPTS] REPOSITORY ARCH
278 OPTS may be
280 --noinit # for faster run
282 --shell-cmd=COMMAND
283 --extra-pkgs=PACKAGE # install additional packages
284 To clean up the build environment run
286 osc wipe [OPTS]
288 osc wipe [OPTS] REPOSITORY ARCH
289 You may set the used VM type in oscrc already, but you can also
291 overwrite it for example with
292 --vm-type=chroot # for faster, but uncleaner and unse‐
294 cure build
295 --vm-type=kvm # for clean and secure build
296 --vm-type=qemu # for slow cross architecture build
297 using system emulator
298 # Note: # Configuration can be overridden by envvars, e.g. #
300 OSC_SU_WRAPPER overrides the setting of su-wrapper. #
301 OSC_BUILD_ROOT overrides the setting of build-root. # OSC_PACK‐
302 AGECACHEDIR overrides the setting of packagecachedir.
303 Options:
305 -h, --help show this help message and exit
306 --nopreinstallimage, --no-preinstallimage
307 Do not use preinstall images for creating the
308 build
309 root.
310 --trust-all-projects
311 trust packages from all projects
312 --host=HOST
313 perform the build on a remote server -
314 user@server:~/remote/directory
315 -f, --force
316 Do not ask for confirmation to wipe
317 --shell-cmd=COMMAND
318 run specified command instead of bash
319 --oldpackages=DIR
320 take previous build from DIR (special values:
321 _self,
322 _link)
323 --download-api-only
324 only fetch packages from the api
325 --disable-cpio-bulk-download
326 disable downloading packages as cpio archive
327 from api
328 --release=N
329 set release number of the package to N
330 -b, --baselibs
331 Create -32bit/-64bit/-x86 rpms for other archi‐
332 tectures
333 --disable-debuginfo
334 disable build of debuginfo packages
335 -d, --debuginfo
336 also build debuginfo sub-packages
337 --alternative-project=PROJECT
338 specify the build target project
339 --target=TARGET
340 define target platform
341 --vm-telnet=TELNET
342 Launch a telnet server inside of VM build
343 --vm-type=TYPE
344 use VM type TYPE (e.g. kvm)
345 --vm-disk-size=DISKSIZE
346 size for newly created disk image in MB
347 --vm-memory=MEMORY
348 amount of memory for VM defined in MB
349 --linksources
350 use hard links instead of a deep copied source
351 --local-package
352 build a package which does not exist on the
353 server
354 --build-uid=uid:gid|"caller"
355 specify the numeric uid:gid pair to assign to
356 the
357 unprivileged "abuild" user or use "caller" to
358 use the
359 current user uid:gid
360 --userootforbuild, --login-as-root
361 Run build or shell as root. The default is to
362 build as
363 unprivileged user. Note that a line "# noroot‐
364 forbuild"
365 in the spec file will invalidate this option.
366 --build-opt=OPT
367 pass option OPT to the build command
368 --define='X Y'
369 define macro X with value Y
370 --without=X
371 disable feature X for build
372 --with=X enable feature X for build
373 --pkg-ccache=/path/to/_ccache.tar
374 path to an existing uncompressed archive ccache.
375 Using
376 this option implies --ccache
377 --ccache use ccache to speed up rebuilds
378 --icecream=N
379 use N parallel build jobs with icecream
380 -t N, --threads=N
381 Compile with N threads
382 -j N, --jobs=N
383 Compile with N jobs
384 --root=ROOT
385 Build in specified directory
386 -x PAC, --extra-pkgs=PAC
387 Add this package when installing the build-root
388 -M MPAC, --multibuild-package=MPAC
389 Build the specified multibuild package
390 -k DIR, --keep-pkgs=DIR
391 Save built packages into this directory
392 -p DIR, --prefer-pkgs=DIR
393 Prefer packages from this directory when
394 installing
395 the build-root
396 --noservice, --no-service
397 Skip run of local source services as specified
398 in
399 _service file.
400 --nodebugpackages, --no-debug-packages
401 Skip installation of additional debug packages
402 for CLI
403 builds
404 --no-verify, --noverify
405 Skip signature verification (via pgp keys) of
406 packages
407 used for build. (Global config in oscrc: no_ver‐
408 ify)
409 --nochecks, --no-checks
410 Do not run build checks on the resulting pack‐
411 ages.
412 --noinit, --no-init
413 Skip initialization of build root and start with
414 build
415 immediately.
416 --overlay=OVERLAY
417 Copy overlay filesystem to buildroot after
418 installing
419 all RPMs .
420 --rsync-dest=RSYNCDESTPATH
421 Copy folder to buildroot after installing all
422 RPMs.
423 Use together with --rsync-src. This is the path
424 on the
425 TARGET filesystem e.g.
426 /usr/src/packages/BUILD/linux-2.6 .
427 --rsync-src=RSYNCSRCPATH
428 Copy folder to buildroot after installing all
429 RPMs.
430 Use together with --rsync-dest. This is the path
431 on
432 the HOST filesystem e.g. /tmp/linux-kernel-tree.
433 It
434 defines RSYNCDONE 1 .
435 --no-changelog
436 don't update the package changelog from a
437 changes file
438 -l, --preload
439 Preload all files into the cache for offline
440 operation
441 -o, --offline
442 Start with cached prjconf and packages without
443 contacting the api server
444 --clean Delete old build root before initializing it
445 buildconfig
449 Shows the build config
450 Shows the build configuration which is used in building a pack‐
452 age. This command is mostly used internally by the 'build' com‐
453 mand.
454 The returned data is the project-wide build configuration in a
456 format which is directly readable by the build script. It con‐
457 tains RPM macros and BuildRequires expansions, for example.
458 The argument REPOSITORY an be taken from the first column of the
460 'osc repos' output.
461 usage:
463 osc buildconfig REPOSITORY (in pkg or
464 prj dir)
465 osc buildconfig PROJECT REPOSITORY
466 buildhistory (buildhist)
469 Shows the build history of a package
470 The arguments REPOSITORY and ARCH can be taken from the first
472 two columns of the 'osc repos' output.
473 usage:
475 osc buildhist REPOSITORY ARCHITECTURE
476 osc buildhist PROJECT PACKAGE REPOSITORY ARCHITECTURE
477 Options:
478 -h, --help show this help message and exit
479 -M MPAC, --multibuild-package=MPAC
480 Show the buildhistory of the specified multi‐
481 build
482 package
483 -l limit, --limit=limit
484 for setting the number of results
485 --csv generate output in CSV (separated by |)
486 buildinfo
490 Shows the build info
491 Shows the build "info" which is used in building a package.
493 This command is mostly used internally by the 'build' subcom‐
494 mand. It needs to be called from within a package directory.
495 The BUILD_DESCR argument is optional. BUILD_DESCR is a local RPM
497 specfile or Debian "dsc" file. If specified, it is sent to the
498 server, and the buildinfo will be based on it. If the argument
499 is not supplied, the buildinfo is derived from the specfile
500 which is currently on the source repository server.
501 The returned data is XML and contains a list of the packages
503 used in building, their source, and the expanded BuildRequires.
504 The arguments REPOSITORY and ARCH are optional. They can be
506 taken from the first two columns of the 'osc repos' output. If
507 not specified, REPOSITORY defaults to the 'build_repository'
508 config entry in your 'oscrc' and ARCH defaults to your host
509 architecture.
510 usage:
512 in a package working copy:
513 osc buildinfo [OPTS] REPOSITORY ARCH BUILD_DESCR
514 osc buildinfo [OPTS] REPOSITORY (ARCH = hostarch,
515 BUILD_DESCR is detected automatically)
516 osc buildinfo [OPTS] ARCH (REPOSITORY = build_repository
517 (config option), BUILD_DESCR is detected automatically)
518 osc buildinfo [OPTS] BUILD_DESCR (REPOSITORY =
519 build_repository (config option), ARCH = hostarch)
520 osc buildinfo [OPTS] (REPOSITORY = build_repository
521 (config option), ARCH = hostarch, BUILD_DESCR is detected auto‐
522 matically)
523 Note: if BUILD_DESCR does not exist locally the remote
524 BUILD_DESCR is used
525 osc buildinfo [OPTS] PROJECT PACKAGE REPOSITORY ARCH
527 [BUILD_DESCR]
528 Options:
530 -h, --help show this help message and exit
531 -p DIR, --prefer-pkgs=DIR
532 Prefer packages from this directory when
533 installing
534 the build-root
535 -x PAC, --extra-pkgs=PAC
536 Add this package when computing the buildinfo
537 -M MPAC, --multibuild-package=MPAC
538 Show the buildinfo of the specified multibuild
539 package
540 --alternative-project=PROJECT
541 specify the build target project
542 -d, --debug
543 verbose output of build dependencies
544 buildlog (bl, blt, buildlogtail)
548 Shows the build log of a package
549 Shows the log file of the build of a package. Can be used to
551 follow the log while it is being written. Needs to be called
552 from within a package directory.
553 When called as buildlogtail (or blt) it just shows the end of
555 the logfile. This is useful to see just a build failure rea‐
556 sons.
557 The arguments REPOSITORY and ARCH are the first two columns in
559 the 'osc results' output. If the buildlog url is used buildlog
560 command has the same behavior as remotebuildlog.
561 Usage:
563 osc buildlog [ARGS...]
564 [REPOSITORY ARCH | BUILDLOGURL] Options:
566 -h, --help show this help message and exit
567 -s, --strip-time
568 strip leading build time from the log
569 -o OFFSET, --offset=OFFSET
570 get log start or end from the offset
571 -M MPAC, --multibuild-package=MPAC
572 get log of the specified multibuild package
573 -l, --last Show the last finished log file
574 cat (blame, less)
578 Output the content of a file to standard output
579 Examples:
581 osc cat file
582 osc cat project package file
583 osc cat project/package/file
584 osc cat http://api.opensuse.org/build/.../_log
585 osc cat http://api.opensuse.org/source/../_link
586 osc less file
588 osc less project package file
589 osc blame file
591 osc blame project package file
592 Usage:
594 osc cat [ARGS...]
595 Options:
597 -h, --help show this help message and exit
598 -M, --meta list meta data files
599 -D, --deleted
600 access file in a deleted package
601 -u, --unexpand
602 always work with unexpanded packages.
603 -e, --expand
604 (default) force expansion of linked packages.
605 -r rev, --revision=rev
606 print out the specified revision
607 changedevelrequest (changedevelreq, cr)
611 Create request to change the devel package definition.
612 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
614 for information on this topic.]
615 See the "request" command for showing and modifying existing
617 requests.
618 osc changedevelrequest PROJECT PACKAGE DEVEL_PROJECT
620 [DEVEL_PACKAGE]
621 checkconstraints
624 check the constraints and view compliant workers
625 Checks the constraints for compliant workers.
627 usage:
629 remote request:
630 osc checkconstraints [OPTS] PROJECT PACKAGE REPOSITORY
631 ARCH
632 in a package working copy:
634 osc checkconstraints [OPTS] REPOSITORY ARCH CONSTRAINTS‐
635 FILE
636 osc checkconstraints [OPTS] CONSTRAINTSFILE
637 osc checkconstraints [OPTS]
638 Options:
640 -h, --help show this help message and exit
641 --ignore-file
642 ignore _constraints file and only check project
643 constraints
644 checkout (co)
648 Check out content from the repository
649 Check out content from the repository server, creating a local
651 working copy.
652 When checking out a single package, the option --revision can be
654 used to specify a revision of the package to be checked out.
655 When a package is a source link, then it will be checked out in
657 expanded form. If --unexpand-link option is used, the checkout
658 will instead produce the raw _link file plus patches.
659 usage:
661 osc co PROJECT [PACKAGE] [FILE]
662 osc co PROJECT # entire project
663 osc co PROJECT PACKAGE # a package
664 osc co PROJECT PACKAGE FILE # single file -> to
665 current dir
666 while inside a project directory:
668 osc co PACKAGE # check out PACKAGE
669 from project
670 with the result of rpm -q --qf '%{DISTURL}0 PACKAGE
672 osc co obs://API/PROJECT/PLATFORM/REVISION-PACKAGE
673 Options:
675 -h, --help show this help message and exit
676 -l limit_size, --limit-size=limit_size
677 Skip all files with a given size
678 -S, --server-side-source-service-files
679 Use server side generated sources instead of
680 local
681 generation.
682 -s, --source-service-files
683 Run source services.
684 -o outdir, --output-dir=outdir
685 place package in the specified directory instead
686 of a
687 PROJECT/PACKAGE directory
688 -c, --current-dir
689 place PACKAGE folder in the current directory
690 instead
691 of a PROJECT/PACKAGE directory
692 -M, --meta checkout out meta data instead of sources
693 -u, --unexpand-link
694 if a package is a link, check out the _link file
695 instead of the expanded sources
696 -D, --deleted
697 checkout an already deleted package. No meta
698 information
699 -e, --expand-link
700 if a package is a link, check out the expanded
701 sources
702 (no-op, since this became the default)
703 -r rev, --revision=rev
704 checkout the specified revision. NOTE: if you
705 checkout
706 the complete project this option is ignored!
707 clean removes all untracked files from the package working copy
711 Examples:
713 osc clean <path>
714 Note: if <path> is omitted it defaults to '.' (<path> has to
716 be a package working copy)
717 Warning: This command removes all files with status '?'.
719 Usage:
721 osc clean [ARGS...]
722 Options:
724 -h, --help show this help message and exit
725 -n, --dry-run
726 print the results without actually removing a
727 file
728 comment
732 List / create / delete comments
733 On create:
735 If -p is given a reply to the ID is created. Otherwise
736 a toplevel comment is created.
737 If -c is not given the default editor will be opened and
738 you can type your comment
739 usage:
741 osc comment list package PROJECT PACKAGE
742 osc comment list project PROJECT
743 osc comment list request REQUEST_ID
744 osc comment create [-p PARENT_ID] [-c COMMENT] package
746 PROJECT PACKAGE
747 osc comment create [-p PARENT_ID] [-c COMMENT] project
748 PROJECT
749 osc comment create [-p PARENT_ID] [-c COMMENT] request
750 REQUEST_ID
751 osc comment delete ID
753 commit (checkin, ci)
757 Upload content to the repository server
758 Upload content which is changed in your working copy, to the
760 repository server.
761 examples:
763 osc ci # current dir
764 osc ci <dir>
765 osc ci file1 file2 ...
766 Usage:
768 osc commit [ARGS...]
769 Options:
771 -h, --help show this help message and exit
772 --skip-local-service-run, --noservice
773 Skip service run of configured source services
774 for
775 local run
776 -v, --verbose
777 Run the source services with verbose information
778 --skip-validation
779 deprecated, don't use it
780 -f, --force
781 force commit, even if there were no changes
782 -F FILE, --file=FILE
783 read log message from FILE, '-' denotes standard
784 input.
785 -n, --no-message
786 do not specify a log message
787 -m TEXT, --message=TEXT
788 specify log message TEXT
789 config get/set a config option
793 Examples:
795 osc config section option (get current value)
796 osc config section option value (set to value)
797 osc config section option --delete (delete option/reset to
798 the default)
799 osc config section --change-password (changes the password
800 in section "section")
801 (section is either an apiurl or an alias or 'general')
802 osc config --dump (dump the complete configuration)
803 Usage:
805 osc config [ARGS...]
806 Options:
808 -h, --help show this help message and exit
809 --dump-full
810 dump the complete configuration (including
811 'pass' and
812 'passx' options)
813 --dump dump the complete configuration (without 'pass'
814 and
815 'passx' options)
816 --no-echo prompt for a value but do not echo entered char‐
817 acters
818 --select-password-store
819 Change the password store
820 --change-password
821 Change password
822 -p, --prompt
823 prompt for a value
824 -s, --stdin
825 indicates that the config value should be read
826 from
827 stdin
828 -d, --delete
829 delete option from config or reset option to the
830 default)
831 copypac
835 Copy a package
836 A way to copy package to somewhere else.
838 It can be done across buildservice instances, if the -t option
840 is used. In that case, a client-side copy and link expansion
841 are implied.
842 Using --client-side-copy always involves downloading all files,
844 and uploading them to the target.
845 The DESTPAC name is optional; the source packages' name will be
847 used if DESTPAC is omitted.
848 usage:
850 osc copypac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
851 -h, --help show this help message and exit
852 -e, --expand
853 if the source package is a link then copy the
854 expanded
855 version of the link
856 -m TEXT, --message=TEXT
857 specify message TEXT
858 -t URL, --to-apiurl=URL
859 URL of destination api server. Default is the
860 source
861 api server.
862 -r rev, --revision=rev
863 copy the specified revision.
864 -d, --keep-develproject
865 keep develproject tag in the package metadata
866 -K, --keep-link
867 If the target package is a link, the link is
868 kept, but
869 may be updated. If the source package is a link,
870 its
871 expanded version is considered.
872 -k, --keep-maintainers
873 keep original maintainers. Default is remove all
874 and
875 replace with the one calling the script.
876 -c, --client-side-copy
877 do a (slower) client-side copy
878 createincident
882 Create a maintenance incident
883 [See http://openbuildservice.org/help/manuals/obs-reference-
885 guide/cha.obs.maintenance_setup.html for information on this
886 topic.]
887 This command is asking to open an empty maintenance incident.
889 This can usually only be done by a responsible maintenance team.
890 Please see the "mbranch" command on how to full such a project
891 content and the "patchinfo" command how add the required mainte‐
892 nance update information.
893 usage:
895 osc createincident [ MAINTENANCEPROJECT ] Options:
896 -h, --help show this help message and exit
897 -m TEXT, --message=TEXT
898 specify message TEXT
899 --noaccess Create a hidden project
900 -a ATTRIBUTE, --attribute=ATTRIBUTE
901 Use this attribute to find default maintenance
902 project
903 (default is OBS:MaintenanceProject)
904 createrequest (creq)
908 create multiple requests with a single command
909 usage:
911 osc creq [OPTIONS] [
912 -a submit SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
913 -a delete PROJECT [PACKAGE]
914 -a change_devel PROJECT PACKAGE DEVEL_PROJECT
915 [DEVEL_PACKAGE]
916 -a add_me ROLE PROJECT [PACKAGE]
917 -a add_group GROUP ROLE PROJECT [PACKAGE]
918 -a add_role USER ROLE PROJECT [PACKAGE]
919 -a set_bugowner USER PROJECT [PACKAGE]
920 ]
921 Option -m works for all types of request, the rest work only
923 for submit. example:
924 osc creq -a submit -a delete home:someone:branches:open‐
925 SUSE:Tools -a change_devel openSUSE:Tools osc home:some‐
926 one:branches:openSUSE:Tools -m ok
927 This will submit all modified packages under current direc‐
929 tory, delete project home:someone:branches:openSUSE:Tools and
930 change the devel project to home:someone:branches:openSUSE:Tools
931 for package osc in project openSUSE:Tools. Options:
932 -h, --help show this help message and exit
933 --yes proceed without asking.
934 --no-update
935 never touch source package on accept (will break
936 source links)
937 --no-cleanup
938 never remove source package on accept, but
939 update its
940 content
941 --cleanup remove package if submission gets accepted
942 (default
943 for home:<id>:branch projects)
944 --nodevelproject
945 do not follow a defined devel project (primary
946 project
947 where a package is developed)
948 -s REQUEST_ID, --supersede=REQUEST_ID
949 Superseding another request by this one
950 -r REV, --revision=REV
951 for "create", specify a certain source revision
952 ID
953 (the md5 sum)
954 -m TEXT, --message=TEXT
955 specify message TEXT
956 -a, --action
957 specify action type of a request, can be :
958 submit/delete/change_devel/add_role/set_bugowner
959 delete (del, remove, rm)
963 Mark files or package directories to be deleted upon the next
964 'checkin'
965 usage:
967 cd .../PROJECT/PACKAGE
968 osc delete FILE [...]
969 cd .../PROJECT
970 osc delete PACKAGE [...]
971 This command works on check out copies. Use "rdelete" for work‐
973 ing on server side only. This is needed for removing the entire
974 project.
975 As a safety measure, projects must be empty (i.e., you need to
977 delete all packages first).
978 If you are sure that you want to remove a package and all its
980 files use '--force' switch. Sometimes this also works without
981 --force.
982 Options:
984 -h, --help show this help message and exit
985 -f, --force
986 forces removal of entire package and its files
987 deleterequest (deletereq, dr, dropreq, droprequest)
991 Request to delete (or 'drop') a package or project
992 usage:
994 osc deletereq [-m TEXT] # works in
995 checked out project/package
996 osc deletereq [-m TEXT] PROJECT PACKAGE
997 osc deletereq [-m TEXT] PROJECT [--all|--repository REPOSI‐
998 TORY] Options:
999 -h, --help show this help message and exit
1000 --accept-in-hours=HOURS
1001 specify time when request shall get accepted
1002 automatically. Only works with write permissions
1003 in
1004 target.
1005 --all deletes entire project with packages inside
1006 -r REPOSITORY, --repository=REPOSITORY
1007 specify repository
1008 -m TEXT, --message=TEXT
1009 specify message TEXT
1010 dependson
1014 dependson shows the build dependencies inside of a project,
1015 valid for a given repository and architecture.
1016 The command can be used to find build dependencies (wrt. a given
1018 repository and arch) that reside in the same project. To see all
1019 build dependencies use the buildinfo command.
1020 This is no guarantee, since the new build might have changed
1022 dependencies.
1023 NOTE: to see all binary packages, which can trigger a build you
1025 need to
1026 refer the buildinfo, since this command shows only the
1027 dependencies
1028 inside of a project.
1029 The arguments REPOSITORY and ARCH can be taken from the first
1031 two columns of the 'osc repos' output.
1032 usage in package or project directory:
1034 osc dependson REPOSITORY ARCH
1035 usage:
1037 osc dependson PROJECT [PACKAGE] REPOSITORY ARCH
1038 detachbranch
1042 replace a link with its expanded sources
1043 If a package is a link it is replaced with its expanded sources.
1045 The link does not exist anymore.
1046 usage:
1048 osc detachbranch # can be used in package
1049 working copy
1050 osc detachbranch PROJECT PACKAGE Options:
1051 -h, --help show this help message and exit
1052 -m TEXT, --message=TEXT
1053 specify message TEXT
1054 develproject (bsdevelproject, dp)
1058 print the devel project / package of a package
1059 Examples:
1061 osc develproject PRJ PKG
1062 osc develproject Options:
1063 -h, --help show this help message and exit
1064 -r, --raw deprecated option
1065 diff (di, ldiff, linkdiff)
1069 Generates a diff
1070 Generates a diff, comparing local changes against the repository
1072 server.
1073 Usage:
1075 osc diff [ARGS...]
1076 ARG, if specified, is a filename to include in the diff.
1078 Default: all files.
1079 osc diff --link
1081 osc linkdiff
1082 Compare current checkout directory against the link
1083 base.
1084 osc diff --link PROJ PACK
1086 osc linkdiff PROJ PACK
1087 Compare a package against the link base (ignoring work‐
1088 ing copy changes).
1089 Options:
1091 -h, --help show this help message and exit
1092 -u, --unexpand
1093 Local changes only, ignore changes in linked
1094 package
1095 sources
1096 --missingok
1097 do not fail if the source or target
1098 project/package
1099 does not exist on the server
1100 -l, --link (osc linkdiff): compare against the base revi‐
1101 sion of
1102 the link
1103 -p, --plain
1104 output the diff in plain (not unified) diff for‐
1105 mat
1106 -M, --meta operate on meta files
1107 -r rev1[:rev2], --revision=rev1[:rev2]
1108 If rev1 is specified it will compare your work‐
1109 ing copy
1110 against the revision (rev1) on the server. If
1111 rev1 and
1112 rev2 are specified it will compare rev1 against
1113 rev2
1114 (NOTE: changes in your working copy are ignored
1115 in
1116 this case)
1117 -c rev, --change=rev
1118 the change made by revision rev (like -r
1119 rev-1:rev).If
1120 rev is negative this is like -r rev:rev-1.
1121 distributions (dists)
1125 Shows all available distributions
1126 This command shows the available distributions. For active dis‐
1128 tributions it shows the name, project and name of the repository
1129 and a suggested default repository name.
1130 usage:
1132 osc distributions
1133 enablechannels (enablechannel)
1137 Enables channels
1138 Enables existing channel packages in a project. Enabling means
1140 adding the needed repositories for building. The command can be
1141 used to enable a specific one or all channels of a project.
1142 Examples:
1144 osc enablechannels [PROJECT [CHANNEL_PACKAGE]]
1145 getbinaries
1148 Download binaries to a local directory
1149 This command downloads packages directly from the api server.
1151 Thus, it directly accesses the packages that are used for build‐
1152 ing others even when they are not "published" yet.
1153 usage:
1155 osc getbinaries REPOSITORY #
1156 works in checked out project/package (check out all archs in
1157 subdirs)
1158 osc getbinaries REPOSITORY ARCHITECTURE #
1159 works in checked out project/package
1160 osc getbinaries PROJECT REPOSITORY ARCHITECTURE
1161 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE
1162 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE FILE
1163 Options:
1164 -h, --help show this help message and exit
1165 --ccache allow fetching ccache archive
1166 --debug also fetch debug packages
1167 --sources also fetch source packages
1168 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1169 AGE
1170 get binaries from specified multibuild package
1171 -d DIR, --destdir=DIR
1172 destination directory
1173 -q, --quiet
1174 do not show downloading progress
1175 help (?, h)
1179 give detailed help on a specific sub-command
1180 usage:
1182 osc help [SUBCOMMAND]
1183 importsrcpkg
1186 Import a new package from a src.rpm
1187 A new package dir will be created inside the project dir (if no
1189 project is specified and the current working dir is a project
1190 dir the package will be created in this project). If the package
1191 does not exist on the server it will be created too otherwise
1192 the meta data of the existing package will be updated (<title />
1193 and <description />). The src.rpm will be extracted into the
1194 package dir. The files won't be committed unless you explicitly
1195 pass the --commit switch.
1196 SRPM is the path of the src.rpm in the local filesystem, or an
1198 URL.
1199 Usage:
1201 osc importsrcpkg SRPM
1202 Options:
1204 -h, --help show this help message and exit
1205 -c, --commit
1206 commit the new files
1207 --delete-old-files
1208 delete existing files from the server
1209 -d description, --description=description
1210 set the description of the package
1211 -t title, --title=title
1212 set a title
1213 -n name, --name=name
1214 specify a package name
1215 -p project, --project=project
1216 specify the path to a project
1217 info Print information about a working copy
1221 Print information about each ARG (default: '.') ARG is a work‐
1223 ing-copy path.
1224 Usage:
1226 osc info [ARGS...]
1227 init Initialize a directory as working copy
1231 Initialize an existing directory to be a working copy of an
1233 (already existing) buildservice project/package.
1234 (This is the same as checking out a package and then copying
1236 sources into the directory. It does NOT create a new package. To
1237 create a package, use 'osc meta pkg ... ...')
1238 You wouldn't normally use this command.
1240 To get a working copy of a package (e.g. for building it or
1242 working on it, you would normally use the checkout command. Use
1243 "osc help checkout" to get help for it.
1244 usage:
1246 osc init PRJ
1247 osc init PRJ PAC
1248 jobhistory (jobhist)
1251 Shows the job history of a project
1252 The arguments REPOSITORY and ARCH can be taken from the first
1254 two columns of the 'osc repos' output.
1255 usage:
1257 osc jobhist REPOSITORY ARCHITECTURE (in project dir)
1258 osc jobhist PROJECT [PACKAGE] REPOSITORY ARCHITECTURE
1259 Options:
1260 -h, --help show this help message and exit
1261 -M MPAC, --multibuild-package=MPAC
1262 get jobhistory for the specified multibuild
1263 package
1264 -l limit, --limit=limit
1265 for setting the number of results
1266 --csv generate output in CSV (separated by |)
1267 linkpac
1271 "Link" a package to another package
1272 A linked package is a clone of another package, but plus local
1274 modifications. It can be cross-project.
1275 The DESTPAC name is optional; the source packages' name will be
1277 used if DESTPAC is omitted.
1278 Afterwards, you will want to 'checkout DESTPRJ DESTPAC'.
1280 To add a patch, add the patch as file and add it to the _link
1282 file. You can also specify text which will be inserted at the
1283 top of the spec file.
1284 See the examples in the _link file.
1286 NOTE: In case you want to fix or update another package, you
1288 should use the 'branch'
1289 command. A branch has correct repositories (and a link)
1290 setup up by default and
1291 will be cleaned up automatically after it was submitted
1292 back.
1293 usage:
1295 osc linkpac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
1296 -h, --help show this help message and exit
1297 -N, --new-package
1298 create a link to a not yet existing package
1299 -d, --disable-publish
1300 disable publishing of the linked package
1301 -f, --force
1302 overwrite an existing link file if it is there.
1303 -r rev, --revision=rev
1304 link the specified revision.
1305 -c, --current
1306 link fixed against current revision.
1307 -C CICOUNT, --cicount=CICOUNT
1308 cicount attribute in the link, known values are
1309 add,
1310 copy, and local, default in buildservice is cur‐
1311 rently
1312 add.
1313 linktobranch
1317 Convert a package containing a classic link with patch to a
1318 branch
1319 This command tells the server to convert a _link with or without
1321 a project.diff to a branch. This is a full copy with a _link
1322 file pointing to the branched place.
1323 usage:
1325 osc linktobranch # can be used in checked
1326 out package
1327 osc linktobranch PROJECT PACKAGE
1328 list (LL, lL, ll, ls)
1331 List sources or binaries on the server
1332 Examples for listing sources:
1334 ls # list all projects (deprecated)
1335 ls / # list all projects
1336 ls . # take PROJECT/PACKAGE from cur‐
1337 rent dir.
1338 ls PROJECT # list packages in a project
1339 ls PROJECT PACKAGE # list source files of package of
1340 a project
1341 ls PROJECT PACKAGE <file> # list <file> if this file exists
1342 ls -v PROJECT PACKAGE # verbosely list source files of
1343 package
1344 ls -l PROJECT PACKAGE # verbosely list source files of
1345 package
1346 ll PROJECT PACKAGE # verbosely list source files of
1347 package
1348 LL PROJECT PACKAGE # verbosely list source files of
1349 expanded link
1350 With --verbose, the following fields will be shown for each
1352 item:
1353 MD5 hash of file
1354 Revision number of the last commit
1355 Size (in bytes)
1356 Date and time of the last commit
1357 Examples for listing binaries:
1359 ls -b PROJECT # list all binaries of a project
1360 ls -b PROJECT -a ARCH # list ARCH binaries of a project
1361 ls -b PROJECT -r REPO # list binaries in REPO
1362 ls -b PROJECT PACKAGE REPO ARCH
1363 Usage:
1365 list (LL, lL, ll, ls) [PROJECT [PACKAGE]]
1366 list (LL, lL, ll, ls) -b [PROJECT [PACKAGE [REPO [ARCH]]]]
1367 Options:
1368 -h, --help show this help message and exit
1369 -R REVISION, --revision=REVISION
1370 specify revision (only for sources)
1371 -M, --meta list meta data files
1372 -D, --deleted
1373 show only the former deleted projects or pack‐
1374 ages
1375 -l, --long print extra information
1376 -v, --verbose
1377 print extra information
1378 -u, --unexpand
1379 always work with unexpanded (source) packages
1380 -e, --expand
1381 expand linked package (only for sources)
1382 -b, --binaries
1383 list built binaries instead of sources
1384 -r REPO, --repo=REPO
1385 specify repository (only for binaries)
1386 -a ARCH, --arch=ARCH
1387 specify architecture (only for binaries)
1388 localbuildlog (lbl)
1392 Shows the build log of a local buildchroot
1393 usage:
1395 osc lbl [REPOSITORY [ARCH]]
1396 osc lbl # show log of newest last local build
1397 Options:
1399 -h, --help show this help message and exit
1400 -s, --strip-time
1401 strip leading build time from the log
1402 -o OFFSET, --offset=OFFSET
1403 get log starting from offset
1404 lock Locks a project or package.
1408 usage:
1410 osc lock PROJECT [PACKAGE]
1411 Options:
1413 -h, --help show this help message and exit
1414 -m TEXT, --message=TEXT
1415 specify log message TEXT
1416 log Shows the commit log of a package
1420 Usage:
1422 osc log (inside working copy)
1423 osc log remote_project [remote_package]
1424 Options:
1426 -h, --help show this help message and exit
1427 -M, --meta checkout out meta data instead of sources
1428 -D, --deleted
1429 work on deleted package
1430 --xml generate output in XML
1431 --csv generate output in CSV (separated by |)
1432 -r rev, --revision=rev
1433 show log of the specified revision
1434 maintainer (bugowner)
1438 Show maintainers according to server side configuration
1439 # Search for official maintained sources in OBS instance
1441 osc maintainer BINARY <options>
1442 osc maintainer -U <user> <options>
1443 osc maintainer -G <group> <options>
1444 # Lookup via containers
1446 osc maintainer <options>
1447 osc maintainer PRJ <options>
1448 osc maintainer PRJ PKG <options>
1449 The tool looks up the default responsible person for a certain
1451 project or package. When using with an OBS 2.4 (or later)
1452 server it is doing the lookup for a given binary according to
1453 the server side configuration of default owners.
1454 The tool is also looking into devel packages and supports to
1456 fallback to the project in case a package has no defined main‐
1457 tainer.
1458 Please use "osc meta pkg" in case you need to know the defini‐
1460 tion in a specific container.
1461 PRJ and PKG default to current working-copy path.
1463 Usage:
1465 osc maintainer [ARGS...]
1466 Options:
1468 -h, --help show this help message and exit
1469 -m MESSAGE, --message=MESSAGE
1470 Define message as commit entry or request
1471 description
1472 -r role, --role=role
1473 Specify user role
1474 -d user, --delete=user
1475 delete a maintainer/bugowner (can be specified
1476 via
1477 --role)
1478 -G GROUP, --group=GROUP
1479 All official maintained instances for the speci‐
1480 fied
1481 GROUP
1482 -U USER, --user=USER
1483 All official maintained instances for the speci‐
1484 fied
1485 USER
1486 -S user, --set-bugowner-request=user
1487 Set the bugowner to specified person via a
1488 request (or
1489 group via group: prefix)
1490 -s user, --set-bugowner=user
1491 Set the bugowner to specified person (or group
1492 via
1493 group: prefix)
1494 -A, --all list all found entries not just the first one
1495 -a user, --add=user
1496 add a new person for given role ("maintainer" by
1497 default)
1498 -D devel_project, --devel-project=devel_project
1499 define the project where this package is primar‐
1500 ily
1501 developed
1502 -v, --verbose
1503 show more information
1504 --nodevelproject
1505 do not follow a defined devel project (primary
1506 project
1507 where a package is developed)
1508 -e, --email
1509 show email addresses instead of user names
1510 -B, --bugowner
1511 Show only the bugowner if defined, or maintainer
1512 otherwise
1513 -b, --bugowner-only
1514 Show only the bugowner
1515 maintenancerequest (mr)
1519 Create a request for starting a maintenance incident.
1520 [See http://openbuildservice.org/help/manuals/obs-reference-
1522 guide/cha.obs.maintenance_setup.html for information on this
1523 topic.]
1524 This command is asking the maintenance team to start a mainte‐
1526 nance incident based on a created maintenance update. Please see
1527 the "mbranch" command on how to create such a project and the
1528 "patchinfo" command how add the required maintenance update
1529 information.
1530 usage:
1532 osc maintenancerequest [ SOURCEPROJECT [ SOURCEPACKAGES
1533 RELEASEPROJECT ] ]
1534 osc maintenancerequest .
1535 The 2nd line when issued within a package directory provides a
1537 short cut to submit a single package (the one in the current
1538 directory) from the project of this package to be submitted to
1539 the release project this package links to. This syntax is only
1540 valid when specified from a package subdirectory. Options:
1541 -h, --help show this help message and exit
1542 -s REQUEST_ID, --supersede=REQUEST_ID
1543 Superseding another request by this one
1544 --incident-project=INCIDENT_PROJECT
1545 specify incident project to merge in
1546 --incident=INCIDENT
1547 specify incident number to merge in
1548 --cleanup do remove source project on accept
1549 --no-cleanup
1550 do not remove source project on accept
1551 --enforce-branching
1552 submit from a fresh branched project
1553 --release-project=RELEASEPROJECT
1554 Specify the release project
1555 -m TEXT, --message=TEXT
1556 specify message TEXT
1557 -a ATTRIBUTE, --attribute=ATTRIBUTE
1558 Use this attribute to find default maintenance
1559 project
1560 (default is OBS:MaintenanceProject)
1561 man generates a man page
1565 usage:
1567 osc man
1568 mbranch (maintained, sm)
1571 Search or branch multiple instances of a package
1572 This command is used for searching all relevant instances of
1574 packages and creating links of them in one project. This is
1575 esp. used for maintenance updates. It can also be used to branch
1576 all packages marked before with a given attribute.
1577 [See http://en.opensuse.org/openSUSE:Build_Service_Concept_Main‐
1579 tenance for information on this topic.]
1580 The branched package will live in
1582 home:USERNAME:branches:ATTRIBUTE:PACKAGE if nothing else
1583 specified.
1584 If osc maintained or sm is issued only the relevant instances of
1586 a package will be shown. No branch will be created. This is sim‐
1587 ilar to osc mbranch --dryrun.
1588 usage:
1590 osc sm [SOURCEPACKAGE] [-a ATTRIBUTE]
1591 osc mbranch [ SOURCEPACKAGE [ TARGETPROJECT ] ] Options:
1592 -h, --help show this help message and exit
1593 --version print version of maintained package
1594 --nodevelproject
1595 do not follow a defined devel project (primary
1596 project
1597 where a package is developed)
1598 --noaccess Create a hidden project
1599 --dryrun Just simulate the action and report back the
1600 result.
1601 -u UPDATE_ATTRIBUTE,
1602 --update-project-attribute=UPDATE_ATTRIBUTE
1603 Use this attribute to find update projects
1604 (default is
1605 OBS:UpdateProject)
1606 -a ATTRIBUTE, --attribute=ATTRIBUTE
1607 Use this attribute to find affected packages
1608 (default
1609 is OBS:Maintained)
1610 -c, --checkout
1611 Checkout branched package afterwards ('osc bco'
1612 is a
1613 shorthand for this option)
1614 meta Show meta information, or edit it
1618 Show or edit build service metadata of type <prj|pkg|prj‐
1620 conf|user|pattern>.
1621 This command displays metadata on buildservice objects like
1623 projects, packages, or users. The type of metadata is specified
1624 by the word after "meta", like e.g. "meta prj".
1625 prj denotes metadata of a buildservice project. prjconf denotes
1627 the (build) configuration of a project. pkg denotes metadata of
1628 a buildservice package. user denotes the metadata of a user.
1629 group denotes the metadata of a group. pattern denotes instal‐
1630 lation patterns defined for a project.
1631 To list patterns, use 'osc meta pattern PRJ'. An additional
1633 argument will be the pattern file to view or edit.
1634 With the --edit switch, the metadata can be edited. Per default,
1636 osc opens the program specified by the environmental variable
1637 EDITOR with a temporary file. Alternatively, content to be saved
1638 can be supplied via the --file switch. If the argument is '-',
1639 input is taken from stdin: osc meta prjconf home:user | sed ...
1640 | osc meta prjconf home:user -F -
1641 For meta prj and prjconf updates optional commit messages can be
1643 applied with --message.
1644 When trying to edit a non-existing resource, it is created
1646 implicitly.
1647 Examples:
1650 osc meta prj PRJ
1651 osc meta pkg PRJ PKG
1652 osc meta pkg PRJ PKG -e
1653 Usage:
1655 osc meta <prj|prjconf> [-r|--revision REV] ARGS...
1656 osc meta <prj|pkg|prjconf|user|group|pattern> ARGS...
1657 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1658 TEXT] -e|--edit ARGS...
1659 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1660 TEXT] -F|--file ARGS...
1661 osc meta pattern --delete PRJ PATTERN
1662 osc meta attribute PRJ [PKG [SUBPACKAGE]] [--attribute
1663 ATTRIBUTE] [--create [--set <value_list>]|--delete|--set
1664 <value_list>] Options:
1665 -h, --help show this help message and exit
1666 --delete delete a pattern or attribute
1667 -s ATTRIBUTE_VALUES, --set=ATTRIBUTE_VALUES
1668 set attribute values
1669 -R, --remove-linking-repositories
1670 Try to remove also all repositories building
1671 against
1672 remove ones.
1673 -c, --create
1674 create attribute without values
1675 -e, --edit edit metadata
1676 -m TEXT, --message=TEXT
1677 specify log message TEXT. For prj and prjconf
1678 meta
1679 only
1680 -r REV, --revision=REV
1681 checkout given revision instead of head revi‐
1682 sion. For
1683 prj and prjconf meta only
1684 -F FILE, --file=FILE
1685 read metadata from FILE, instead of opening an
1686 editor.
1687 '-' denotes standard input.
1688 -f, --force
1689 force the save operation, allows one to ignores
1690 some
1691 errors like depending repositories. For prj meta
1692 only.
1693 --blame show author and time of each line
1694 --attribute-project
1695 include project values, if missing in packages
1696 --attribute-defaults
1697 include defined attribute defaults
1698 -a ATTRIBUTE, --attribute=ATTRIBUTE
1699 affect only a given attribute
1700 mkpac Create a new package under version control
1704 usage:
1706 osc mkpac new_package
1707 mv Move SOURCE file to DEST and keep it under version control
1710 Usage:
1712 osc mv SOURCE DEST
1713 Options:
1715 -h, --help show this help message and exit
1716 -f, --force
1717 forces removal of entire package and its files
1718 my show waiting work, packages, projects or requests involving
1722 yourself
1723 Examples:
1725 # list all open tasks for me
1726 osc my [work]
1727 # list packages where I am bugowner
1728 osc my pkg -b
1729 # list projects where I am maintainer
1730 osc my prj -m
1731 # list request for all my projects and packages
1732 osc my rq
1733 # list requests, excluding project 'foo' and 'bar'
1734 osc my rq --exclude-project foo,bar
1735 # list requests I made
1736 osc my sr
1737 Usage:
1739 osc my [ARGS...]
1740 where TYPE is one of requests, submitrequests,
1742 projects or packages (rq, sr, prj or pkg)
1743 Options:
1745 -h, --help
1746 show this help message and exit
1747 --maintained
1748 limit search results to packages with maintained
1749 attribute set.
1750 -v, --verbose
1751 verbose listing
1752 --exclude-project=EXCLUDE_PROJECT
1753 exclude requests for specified project
1754 -U USER, --user=USER
1755 search for USER instead of yourself
1756 -a, --all
1757 all involvements
1758 -m, --maintainer
1759 restrict listing to items where the user is
1760 maintainer
1761 -b, --bugowner
1762 restrict listing to items where the user is
1763 bugowner
1764 patchinfo
1768 Generate and edit a patchinfo file.
1769 A patchinfo file describes the packages for an update and the
1771 kind of problem it solves.
1772 This command either creates a new _patchinfo or updates an
1774 existing one.
1775 Examples:
1777 osc patchinfo
1778 osc patchinfo [PROJECT [PATCH_NAME]] Options:
1779 -h, --help show this help message and exit
1780 -f, --force
1781 force generation of new patchinfo file, do not
1782 update
1783 existing one.
1784 pdiff Quick alias to diff the content of a package with its parent.
1788 Usage:
1790 osc pdiff [--plain|-p] [--nomissing-ok|-n]
1791 osc pdiff [--plain|-p] [--nomissing-ok|-n] PKG
1792 osc pdiff [--plain|-p] [--nomissing-ok|-n] PRJ PKG
1793 Options:
1795 -h, --help show this help message and exit
1796 -n, --nomissingok
1797 fail if the parent package does not exist on the
1798 server
1799 -p, --plain
1800 output the diff in plain (not unified) diff for‐
1801 mat
1802 prdiff (projdiff, projectdiff)
1806 Server-side diff of two projects
1807 Compares two projects and either summarizes or outputs the dif‐
1809 ferences in full. In the second form, a project is compared
1810 with one of its branches inside a home:$USER project (the branch
1811 is treated as NEWPRJ). The home branch is optional if the cur‐
1812 rent working directory is a checked out copy of it.
1813 Usage:
1815 osc prdiff [OPTIONS] OLDPRJ NEWPRJ
1816 osc prdiff [OPTIONS] [home:$USER:branch:$PRJ]
1817 Options:
1819 -h, --help show this help message and exit
1820 -d, --diffstat
1821 show diffstat of differences
1822 -u, --unified
1823 show full unified diffs of differences
1824 -o, --show-not-in-new
1825 show packages only in the old project
1826 -n, --show-not-in-old
1827 show packages only in the new project
1828 -i REGEXP, --include=REGEXP
1829 only consider packages matching REGEXP
1830 -e REGEXP, --exclude=REGEXP
1831 skip packages matching REGEXP
1832 -r, --requests
1833 show open requests for any packages with differ‐
1834 ences
1835 prjresults (pr)
1839 Shows project-wide build results
1840 Usage:
1842 osc prjresults (inside working copy)
1843 osc prjresults PROJECT
1844 Options:
1846 -h, --help show this help message and exit
1847 --show-excluded
1848 show packages that are excluded in all repos,
1849 also
1850 hide repos that have only excluded packages
1851 -V, --vertical
1852 list packages vertically instead horizontally
1853 -r REPO, --repo=REPO
1854 show results only for specified repo(s)
1855 -a ARCH, --arch=ARCH
1856 show results only for specified architecture(s)
1857 -n EXPR, --name-filter=EXPR
1858 show only packages whose names match EXPR
1859 -s STATUS, --status-filter=STATUS
1860 show only packages with buildstatus STATUS (see
1861 legend)
1862 --xml generate output in XML
1863 -c, --csv csv output
1864 -w, --watch
1865 watch the results until all finished building,
1866 only
1867 supported with --xml
1868 -q, --hide-legend
1869 hide the legend
1870 pull merge the changes of the link target into your working copy.
1874 rdelete
1878 Delete a project or packages on the server.
1879 As a safety measure, project must be empty (i.e., you need to
1881 delete all packages first). Also, packages must have no requests
1882 pending (i.e., you need to accept/revoke such requests first).
1883 If you are sure that you want to remove this project and all its
1884 packages use '--recursive' switch. It may still not work
1885 because other depends on it. If you want to ignore this as well
1886 use '--force' switch.
1887 usage:
1889 osc rdelete [-r] [-f] PROJECT [PACKAGE]
1890 Options:
1892 -h, --help show this help message and exit
1893 -m TEXT, --message=TEXT
1894 specify log message TEXT
1895 -f, --force
1896 deletes a project where other depends on
1897 -r, --recursive
1898 deletes a project with packages inside
1899 rdiff Server-side "pretty" diff of two packages
1903 Compares two packages (three or four arguments) or shows the
1905 changes of a specified revision of a package (two arguments)
1906 If no revision is specified the latest revision is used.
1908 Note that this command doesn't return a normal diff (which could
1910 be applied as patch), but a "pretty" diff, which also compares
1911 the content of tarballs.
1912 usage:
1915 osc rdiff OLDPRJ OLDPAC NEWPRJ [NEWPAC]
1916 osc rdiff PROJECT PACKAGE Options:
1917 -h, --help show this help message and exit
1918 -u, --unexpand
1919 diff unexpanded version if sources are linked
1920 --missingok
1921 do not fail if the source or target
1922 project/package
1923 does not exist on the server
1924 -c rev, --change=rev
1925 the change made by revision rev (like -r
1926 rev-1:rev).
1927 If rev is negative this is like -r rev:rev-1.
1928 -p, --plain
1929 output the diff in plain (not unified) diff for‐
1930 mat
1931 -r N[:M], --revision=N[:M]
1932 revision id, where N = old revision and M = new
1933 revision
1934 -M, --meta diff meta data
1935 --issues-only
1936 show only issues in diff
1937 --oldpkg=OLDPKG
1938 package to compare against (deprecated, use 3
1939 argument
1940 form)
1941 --oldprj=OLDPRJ
1942 project to compare against (deprecated, use 3
1943 argument
1944 form)
1945 rebuild (rebuildpac)
1949 Trigger package rebuilds
1950 Note that it is normally NOT needed to kick off rebuilds like
1952 this, because they principally happen in a fully automatic way,
1953 triggered by source check-ins. In particular, the order in which
1954 packages are built is handled by the build service.
1955 The arguments REPOSITORY and ARCH can be taken from the first
1957 two columns of the 'osc repos' output.
1958 usage:
1960 osc rebuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]] Options:
1961 -h, --help show this help message and exit
1962 --all Rebuild all packages of entire project
1963 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1964 AGE
1965 rebuild specified multibuild package
1966 -f, --failed
1967 rebuild all failed packages
1968 -r REPO, --repo=REPO
1969 trigger rebuilds for a specific repository
1970 -a ARCH, --arch=ARCH
1971 trigger rebuilds for a specific architecture
1972 release
1976 Release sources and binaries
1977 This command is used to transfer sources and binaries without
1979 rebuilding them. It requires defined release targets set to
1980 trigger="manual". Please refer the release management chapter in
1981 the OBS book for details.
1982 usage:
1984 osc release [ SOURCEPROJECT [ SOURCEPACKAGE ] ]
1985 Options:
1987 -h, --help show this help message and exit
1988 --no-delay Don't put the release job in a queue to be run
1989 later,
1990 but immediately run it. Thus the next call to
1991 osc
1992 prjresult will reflect it. Otherwise there is no
1993 way
1994 to know if it is finished or didn't start yet.
1995 --set-release=RELEASETAG
1996 rename binaries during release using this
1997 release tag
1998 --target-repository=TARGETREPOSITORY
1999 Release only to specified repository
2000 --target-project=TARGETPROJECT
2001 Release only to specified project
2002 -r REPO, --repo=REPO
2003 Release only binaries from the specified reposi‐
2004 tory
2005 releaserequest
2009 Create a request for releasing a maintenance update.
2010 [See http://openbuildservice.org/help/manuals/obs-reference-
2012 guide/cha.obs.maintenance_setup.html
2013 for information on this topic.]
2014 This command is used by the maintenance team to start the
2016 release process of a maintenance update. This includes usually
2017 testing based on the defined reviewers of the update project.
2018 usage:
2020 osc releaserequest [ SOURCEPROJECT ]
2021 Options:
2023 -h, --help show this help message and exit
2024 -m TEXT, --message=TEXT
2025 specify message TEXT
2026 remotebuildlog (rbl, rblt, rbuildlog, rbuildlogtail, remotebuildlog‐
2030 tail)
2031 Shows the build log of a package
2032 Shows the log file of the build of a package. Can be used to
2034 follow the log while it is being written.
2035 remotebuildlogtail shows just the tail of the log file.
2037 usage:
2039 osc remotebuildlog project package repository arch
2040 or
2041 osc remotebuildlog project/package/repository/arch
2042 or
2043 osc remotebuildlog buildlogurl Options:
2044 -h, --help show this help message and exit
2045 -s, --strip-time
2046 strip leading build time from the log
2047 -o OFFSET, --offset=OFFSET
2048 get log starting or ending from the offset
2049 -M MPAC, --multibuild-package=MPAC
2050 show log file for specified multibuild package
2051 --lastsucceeded
2052 Show the last succeeded log file
2053 -l, --last Show the last finished log file
2054 repairlink
2058 Repair a broken source link
2059 This command checks out a package with merged source changes. It
2061 uses a 3-way merge to resolve file conflicts. After review‐
2062 ing/repairing the merge, use 'osc resolved ...' and 'osc ci' to
2063 re-create a working source link.
2064 usage: * For merging conflicting changes of a checkout package:
2066 osc repairlink
2067 * Check out a package and merge changes:
2069 osc repairlink PROJECT PACKAGE
2070 * Pull conflicting changes from one project into another one:
2072 osc repairlink PROJECT PACKAGE INTO_PROJECT [INTO_PACKAGE]
2073 Options:
2075 -h, --help show this help message and exit
2076 -d DIR, --destdir=DIR
2077 destination directory
2078 repairwc
2082 try to repair an inconsistent working copy
2083 Examples:
2085 osc repairwc <path>
2086 Note: if <path> is omitted it defaults to '.' (<path> can be
2088 a project or package working copy)
2089 Warning: This command might delete some files in the storedir
2091 (.osc). Please check the state of the wc afterwards (via 'osc
2092 status').
2093 Usage:
2095 osc repairwc [ARGS...]
2096 Options:
2098 -h, --help show this help message and exit
2099 --force-apiurl
2100 ask once for an apiurl and force this apiurl for
2101 all
2102 inconsistent projects/packages
2103 repositories (platforms, repos)
2107 shows repositories configured for a project.
2108 It skips repositories by default which are dis‐
2109 abled for a given package.
2110 usage:
2112 osc repos
2113 osc repos [PROJECT] [PACKAGE]
2114 repourls
2118 Shows URLs of .repo files
2119 Shows URLs on which to access the project .repos files (yum-
2121 style metadata) on download.opensuse.org.
2122 usage:
2124 osc repourls [PROJECT]
2125 request (review, rq)
2129 Show or modify requests and reviews
2130 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2132 for information on this topic.]
2133 The 'request' command has the following sub commands:
2135 "list" lists open requests attached to a project or package or
2137 person. Uses the project/package of the current directory if
2138 none of -M, -U USER, project/package are given.
2139 "log" will show the history of the given ID
2141 "show" will show the request itself, and generate a diff for
2143 review, if used with the --diff option. The keyword show can be
2144 omitted if the ID is numeric.
2145 "decline" will change the request state to "declined"
2147 "reopen" will set the request back to new or review.
2149 "setincident" will direct "maintenance" requests into specific
2151 incidents
2152 "supersede" will supersede one request with another existing
2154 one.
2155 "revoke" will set the request state to "revoked"
2157 "accept" will change the request state to "accepted" and will
2159 trigger the actual submit process. That would normally be a
2160 server-side copy of the source package to the target package.
2161 "approve" marks a requests in "review" state as approved. This
2163 request will get accepted automatically when the last review got
2164 accepted.
2165 "checkout" will checkout the request's source package ("submit"
2167 requests only).
2168 "prioritize" change the priority of a request to either "criti‐
2170 cal", "important", "moderate" or "low"
2171 The 'review' command has the following sub commands:
2174 "list" lists open requests that need to be reviewed by the spec‐
2176 ified user or group
2177 "add" adds a person or group as reviewer to a request
2179 "accept" mark the review positive
2181 "decline" mark the review negative. A negative review will
2183 decline the request.
2184 usage:
2186 osc request list [-M] [-U USER] [-s state] [-D DAYS] [-t
2187 type] [-B] [PRJ [PKG]]
2188 osc request log ID
2189 osc request [show] [-d] [-b] ID
2190 osc request accept [-m TEXT] ID
2192 osc request approve [-m TEXT] ID
2193 osc request cancelapproval [-m TEXT] ID
2194 osc request decline [-m TEXT] ID
2195 osc request revoke [-m TEXT] ID
2196 osc request reopen [-m TEXT] ID
2197 osc request setincident [-m TEXT] ID INCIDENT
2198 osc request supersede [-m TEXT] ID SUPERSEDING_ID
2199 osc request approvenew [-m TEXT] PROJECT
2200 osc request prioritize [-m TEXT] ID PRIORITY
2201 osc request checkout/co ID
2203 osc request clone [-m TEXT] ID
2204 osc review show [-d] [-b] ID
2206 osc review list [-U USER] [-G GROUP] [-P PROJECT [-p PACK‐
2207 AGE]] [-s state]
2208 osc review add [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2209 [-p PACKAGE]] ID
2210 osc review accept [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2211 [-p PACKAGE]] ID
2212 osc review decline [-m TEXT] [-U USER] [-G GROUP] [-P
2213 PROJECT [-p PACKAGE]] ID
2214 osc review reopen [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2215 [-p PACKAGE]] ID
2216 osc review supersede [-m TEXT] [-U USER] [-G GROUP] [-P
2217 PROJECT [-p PACKAGE]] ID SUPERSEDING_ID
2218 Options:
2220 -h, --help show this help message and exit
2221 --source-buildstatus
2222 print the buildstatus of the source package
2223 (only
2224 works with "show" and the interactive review)
2225 --target-package-filter=TARGET_PACKAGE_FILTER
2226 only list requests for the packages matching the
2227 package filter. A (python) regular expression is
2228 expected.
2229 --involved-projects
2230 show all requests for project/packages where
2231 USER is
2232 involved
2233 --incoming Show only requests where the project is target
2234 --exclude-target-project=EXCLUDE_TARGET_PROJECT
2235 exclude target project from request list
2236 --non-interactive
2237 non-interactive review of request
2238 --or-revoke
2239 For automation scripts: accepts (if using with
2240 accept
2241 argument) a request when it is in new or review
2242 state.
2243 Or revoke it when it got declined. Otherwise
2244 just do
2245 nothing.
2246 -i, --interactive
2247 interactive review of request
2248 -e, --edit edit a submit action
2249 -B, --bugowner
2250 also show requests about packages where I am
2251 bugowner
2252 -M, --mine only show requests created by yourself
2253 -b, --brief
2254 print output in list view as list subcommand
2255 -p PACKAGE, --package=PACKAGE
2256 requests or reviews limited for the specified
2257 PACKAGE,
2258 requires also a PROJECT
2259 -P PROJECT, --project=PROJECT
2260 requests or reviews limited for the specified
2261 PROJECT
2262 -G GROUP, --group=GROUP
2263 requests or reviews limited for the specified
2264 GROUP
2265 -U USER, --user=USER
2266 requests or reviews limited for the specified
2267 USER
2268 -D DAYS, --days=DAYS
2269 only list requests in state "new" or changed in
2270 the
2271 last DAYS. [default=0]
2272 -s STATE, --state=STATE
2273 only list requests in one of the comma separated
2274 given
2275 states (new/review/accepted/revoked/declined) or
2276 "all"
2277 [default="declined,new,review", or "all", if no
2278 args
2279 given]
2280 -f, --force
2281 enforce state change, can be used to ignore open
2282 reviews
2283 -a, --all all states. Same as'-s all'
2284 -t TYPE, --type=TYPE
2285 limit to requests which contain a given action
2286 type (s
2287 ubmit/delete/change_devel/add_role/set_bugowner/mainte
2288 nance_incident/maintenance_release)
2289 -m TEXT, --message=TEXT
2290 specify message TEXT
2291 --no-devel Do not attempt to forward to devel project
2292 -u, --unified
2293 output the diff in the unified diff format
2294 -d, --diff generate a diff
2295 requestmaintainership (reqbs, reqbugownership, reqmaintainership,
2299 reqms, requestbugownership)
2300 requests to add user as maintainer or bugowner
2301 usage:
2303 osc requestmaintainership # for
2304 current user in checked out package
2305 osc requestmaintainership USER # for
2306 specified user in checked out package
2307 osc requestmaintainership PROJECT # for
2308 current user if cwd is not a checked out package
2309 osc requestmaintainership PROJECT group:NAME #
2310 request for specified group
2311 osc requestmaintainership PROJECT PACKAGE # for
2312 current user
2313 osc requestmaintainership PROJECT PACKAGE USER #
2314 request for specified user
2315 osc requestmaintainership PROJECT PACKAGE group:NAME #
2316 request for specified group
2317 osc requestbugownership ... #
2319 accepts same parameters but uses bugowner role
2320 Options:
2322 -h, --help show this help message and exit
2323 -r role, --role=role
2324 specify user role (default: maintainer)
2325 -m TEXT, --message=TEXT
2326 specify message TEXT
2327 resolved
2331 Remove 'conflicted' state on working copy files
2332 If an upstream change can't be merged automatically, a file is
2334 put into in 'conflicted' ('C') state. Within the file, conflicts
2335 are marked with special <<<<<<< as well as ======== and >>>>>>>
2336 lines.
2337 After manually resolving all conflicting parts, use this command
2339 to remove the 'conflicted' state.
2340 Note: this subcommand does not semantically resolve conflicts
2342 or remove conflict markers; it merely removes the conflict-
2343 related artifact files and allows PATH to be committed again.
2344 usage:
2346 osc resolved FILE [FILE...]
2347 restartbuild (abortbuild)
2350 Restart the build of a certain project or package
2351 usage:
2353 osc restartbuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]]
2354 Options:
2355 -h, --help show this help message and exit
2356 --all Restart all running builds of entire project
2357 -r REPO, --repo=REPO
2358 Restart builds for a specific repository
2359 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2360 AGE
2361 Restart builds for specified multibuild package
2362 -a ARCH, --arch=ARCH
2363 Restart builds for a specific architecture
2364 results (r)
2368 Shows the build results of a package or project
2369 Usage:
2371 osc results # (inside working copy of PRJ or
2372 PKG)
2373 osc results PROJECT [PACKAGE]
2374 Options:
2376 -h, --help show this help message and exit
2377 --show-excluded
2378 show repos that are excluded for this package
2379 --format=FORMAT
2380 format string for csv output
2381 --csv generate output in CSV format
2382 --xml generate output in XML (former results_meta)
2383 -w, --watch
2384 watch the results until all finished building
2385 -V, --vertical
2386 list packages vertically instead horizontally
2387 for
2388 entire project
2389 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2390 AGE
2391 Only show results for the specified multibuild
2392 package
2393 --no-multibuild
2394 Disable results for all direct affect packages
2395 inside
2396 of the project
2397 -v, --verbose
2398 more verbose output
2399 -a ARCH, --arch=ARCH
2400 Show results only for specified architecture(s)
2401 -r REPO, --repo=REPO
2402 Show results only for specified repo(s)
2403 -l, --last-build
2404 show last build results (suc‐
2405 ceeded/failed/unknown)
2406 revert Restore changed files or the entire working copy.
2410 Examples:
2412 osc revert <modified file(s)>
2413 osc revert . Note: this only works for package working
2414 copies
2415 Usage:
2417 osc revert [FILES...]
2418 rpmlintlog (lint, rpmlint)
2422 Shows the rpmlint logfile
2423 Shows the rpmlint logfile to analyse if there are any problems
2425 with the spec file and the built binaries.
2426 usage:
2428 osc rpmlintlog project package repository arch
2429 rremove
2432 Remove source files from selected package
2433 Usage:
2435 osc rremove PROJECT PACKAGE [FILES...]
2436 Options:
2438 -h, --help show this help message and exit
2439 -f, --force
2440 Don't ask and delete files
2441 search (bse, se)
2445 Search for a project and/or package.
2446 If no option is specified osc will search for projects and pack‐
2448 ages which contains the 'search term' in their name, title or
2449 description.
2450 usage:
2452 osc search 'search term' <options>
2453 osc bse ... ('osc search --binary')
2454 osc se 'perl(Foo::Bar)' ('osc search --package
2455 perl-Foo-Bar') Options:
2456 -h, --help show this help message and exit
2457 --binaryversion=VERSION
2458 search for binary with specified version
2459 (implies
2460 --binary)
2461 -B PROJECT, --baseproject=PROJECT
2462 search packages built for PROJECT (implies
2463 --binary)
2464 --binary search binary packages
2465 --csv generate output in CSV (separated by |)
2466 -M, --mine shorthand for --bugowner --package
2467 --maintained
2468 OBSOLETE: please use maintained command instead.
2469 -m, --maintainer
2470 as -i, but only maintainer
2471 -b, --bugowner
2472 as -i, but only bugowner
2473 -i, --involved
2474 show projects/packages where given person (or
2475 myself)
2476 is involved as bugowner or maintainer
2477 [[{group|person}/]<name>] default: person
2478 -V, --version
2479 show package version, revision, and srcmd5. CAU‐
2480 TION:
2481 This is slow and unreliable
2482 -v, --verbose
2483 show more information
2484 -a ATTRIBUTE, --limit-to-attribute=ATTRIBUTE
2485 match only when given attribute exists in meta
2486 data
2487 --description
2488 search for matches in the 'description' element
2489 --title search for matches in the 'title' element
2490 --project search for a project
2491 --package search for a package
2492 -s, --substring
2493 Show also results where the search term is a sub
2494 string, slower search
2495 -e, --exact
2496 show only exact matches, this is default now
2497 --repos-baseurl
2498 show base URLs of download repositories
2499 sendsysrq
2503 trigger a sysrq in a running build
2504 This is only going to work when the build is running in a sup‐
2506 ported VM. Also only a subset of sysrq are supported. Typical
2507 use case for debugging are 9, t and w in this sequence.
2508 usage:
2510 osc sendsysrq REPOSITORY ARCH SYSRQ
2511 osc sendsysrq PROJECT PACKAGE REPOSITORY ARCH SYSRQ Options:
2512 -h, --help show this help message and exit
2513 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2514 AGE
2515 specify a specific multibuild flavor
2516 service
2520 Handle source services
2521 Source services can be used to modify sources like downloading
2523 files, verify files, generating files or modify existing files.
2524 usage:
2526 osc service COMMAND (inside working copy)
2527 osc service run [SOURCE_SERVICE]
2528 osc service runall
2529 osc service localrun
2530 osc service disabledrun
2531 osc service remoterun [PROJECT PACKAGE]
2532 osc service merge [PROJECT PACKAGE]
2533 osc service wait [PROJECT PACKAGE]
2534 COMMAND can be:
2536 run r run defined services locally, it takes an
2537 optional parameter to run only a
2538 specified source service. In case parameters
2539 exist for this one in _service file
2540 they are used.
2541 runall ra run all services independent of the used mode
2542 localrun lr run all services except the ones with mode
2543 "buildtime", "disabled", or
2544 "serveronly" (deprecated)
2545 disabledrun dr run all services with mode "disabled" or
2546 "serveronly" (deprecated)
2547 remoterun rr trigger a re-run on the server side
2548 merge commits all server side generated files and
2549 drops the _service definition
2550 wait waits until the service finishes and returns
2551 with an error if it failed
2552 setdevelproject (sdp)
2556 Set the devel project / package of a package
2557 Examples:
2559 osc setdevelproject [PRJ PKG] DEVPRJ [DEVPKG] Options:
2560 -h, --help show this help message and exit
2561 -u, --unset
2562 remove devel project
2563 setlinkrev
2567 Updates a revision number in a source link.
2568 This command adds or updates a specified revision number in a
2570 source link. The current revision of the source is used, if no
2571 revision number is specified.
2572 usage:
2574 osc setlinkrev
2575 osc setlinkrev PROJECT [PACKAGE] Options:
2576 -h, --help show this help message and exit
2577 -u, --unset
2578 remove revision in link, it will point always to
2579 latest revision
2580 -R, --use-plain-revision
2581 Do not expand revision the specified or latest
2582 rev
2583 -r rev, --revision=rev
2584 use the specified revision.
2585 signkey
2589 Manage Project Signing Key
2590 osc signkey [--create|--delete|--extend] <PROJECT> osc signkey
2592 [--notraverse] <PROJECT>
2593 This command is for managing gpg keys. It shows the public key
2595 by default. There is no way to download or upload the private
2596 part of a key by design.
2597 However you can create a new own key. You may want to consider
2599 to sign the public key with your own existing key.
2600 If a project has no key, the key from upper level project will
2602 be used (e.g. when dropping "KDE:KDE4:Community" key, the one
2603 from "KDE:KDE4" will be used).
2604 WARNING: THE OLD KEY CANNOT BE RESTORED AFTER USING DELETE OR
2606 CREATE
2607 Usage:
2609 osc signkey [ARGS...]
2610 Options:
2612 -h, --help show this help message and exit
2613 --sslcert fetch SSL certificate instead of GPG key
2614 --notraverse
2615 don't traverse projects upwards to find key
2616 --delete delete the gpg signing key in this project
2617 --extend extend expiration date of the gpg public key for
2618 this
2619 project
2620 --create create new gpg signing key for this project
2621 status (st)
2625 Show status of files in working copy
2626 Show the status of files in a local working copy, indicating
2628 whether files have been changed locally, deleted, added, ...
2629 The first column in the output specifies the status and is one
2631 of the following characters:
2632 ' ' no modifications
2633 'A' Added
2634 'C' Conflicted
2635 'D' Deleted
2636 'M' Modified
2637 'R' Replaced (file was deleted and added again afterwards)
2638 '?' item is not under version control
2639 '!' item is missing (removed by non-osc command) or incomplete
2640 'S' item is skipped (item exceeds a file size limit or is
2641 _service:* file)
2642 'F' Frozen (use "osc pull" to merge conflicts) (package-only
2643 state)
2644 examples:
2646 osc st
2647 osc st <directory>
2648 osc st file1 file2 ...
2649 usage:
2651 osc status [OPTS] [PATH...] Options:
2652 -h, --help show this help message and exit
2653 -e, --show-excluded
2654 also show files which are excluded by the
2655 "exclude_glob" config option
2656 -v, --verbose
2657 print extra information
2658 -q, --quiet
2659 print as little as possible
2660 submitrequest (sr, submitpac, submitreq)
2664 Create request to submit source into another Project
2665 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2667 for information on this topic.]
2668 See the "request" command for showing and modifying existing
2670 requests.
2671 usage:
2673 osc submitreq [OPTIONS]
2674 osc submitreq [OPTIONS] DESTPRJ [DESTPKG]
2675 osc submitreq [OPTIONS] SOURCEPRJ SOURCEPKG DESTPRJ
2676 [DESTPKG]
2677 osc submitpac ... is a shorthand for osc submitreq --cleanup
2679 ...
2680 Options:
2682 -h, --help show this help message and exit
2683 --yes proceed without asking.
2684 -d, --diff show diff only instead of creating the actual
2685 request
2686 --update-link
2687 This transfers the source including the _link
2688 file.
2689 --no-update
2690 never touch source package on accept (will break
2691 source links)
2692 --no-cleanup
2693 never remove source package on accept, but
2694 update its
2695 content
2696 --cleanup remove package if submission gets accepted
2697 (default
2698 for home:<id>:branch projects)
2699 --seperate-requests
2700 Deprecated (wrong spelling - see --sepa‐
2701 rate-requests)
2702 --separate-requests
2703 Create multiple requests instead of a single one
2704 (when
2705 command is used for entire project)
2706 --nodevelproject
2707 do not follow a defined devel project (primary
2708 project
2709 where a package is developed)
2710 -s REQUEST_ID, --supersede=REQUEST_ID
2711 Superseding another request by this one
2712 -r REV, --revision=REV
2713 specify a certain source revision ID (the md5
2714 sum) for
2715 the source package
2716 -m TEXT, --message=TEXT
2717 specify message TEXT
2718 token Show and manage authentication token
2722 Authentication token can be used to run specific commands with‐
2724 out sending credentials.
2725 Usage:
2727 osc token
2728 osc token --create [--operation <OPERATION>] [<PROJECT>
2729 <PACKAGE>]
2730 osc token --delete <TOKENID>
2731 osc token --trigger <TOKENSTRING> [--operation <OPERATION>]
2732 [<PROJECT> <PACKAGE>] Options:
2733 -h, --help show this help message and exit
2734 -t TOKENSTRING, --trigger=TOKENSTRING
2735 Trigger the action of a token
2736 -o OPERATION, --operation=OPERATION
2737 Default is "runservice", but "release" or
2738 "rebuild"
2739 can also be used
2740 -d TOKENID, --delete=TOKENID
2741 Delete a token
2742 -c, --create
2743 Create a new token
2744 triggerreason (tr)
2748 Show reason why a package got triggered to build
2749 The server decides when a package needs to get rebuild, this
2751 command shows the detailed reason for a package. A brief reason
2752 is also stored in the jobhistory, which can be accessed via "osc
2753 jobhistory".
2754 Trigger reasons might be:
2756 - new build (never build yet or rebuild manually forced)
2757 - source change (e.g. on updating sources)
2758 - meta change (packages which are used for building have
2759 changed)
2760 - rebuild count sync (In case that it is configured to sync
2761 release numbers)
2762 usage in package or project directory:
2764 osc triggerreason REPOSITORY ARCH
2765 osc triggerreason PROJECT PACKAGE REPOSITORY ARCH
2766 Options:
2768 -h, --help show this help message and exit
2769 -M MPAC, --multibuild-package=MPAC
2770 get triggerreason of the specified multibuild
2771 package
2772 undelete
2776 Restores a deleted project or package on the server.
2777 The server restores a package including the sources and meta
2779 configuration. Binaries remain to be lost and will be rebuild.
2780 usage:
2782 osc undelete PROJECT
2783 osc undelete PROJECT PACKAGE [PACKAGE ...]
2784 Options:
2786 -h, --help show this help message and exit
2787 -m TEXT, --message=TEXT
2788 specify log message TEXT
2789 unlock Unlocks a project or package
2793 Unlocks a locked project or package. A comment is required.
2795 usage:
2797 osc unlock PROJECT [PACKAGE]
2798 Options:
2800 -h, --help show this help message and exit
2801 -m TEXT, --message=TEXT
2802 specify log message TEXT
2803 update (up)
2807 Update a working copy
2808 examples:
2810 1. osc up
2812 If the current working directory is a package, update
2813 it.
2814 If the directory is a project directory, update all con‐
2815 tained
2816 packages, AND check out newly added packages.
2817 To update only checked out packages, without checking
2819 out new
2820 ones, you might want to use "osc up *" from within the
2821 project
2822 dir.
2823 2. osc up PAC
2825 Update the packages specified by the path argument(s)
2826 When --expand-link is used with source link packages, the
2828 expanded sources will be checked out. Without this option, the
2829 _link file and patches will be checked out. The option --unex‐
2830 pand-link can be used to switch back to the "raw" source with a
2831 _link file plus patch(es).
2832 Usage:
2834 osc update [ARGS...]
2835 Options:
2837 -h, --help show this help message and exit
2838 -l limit_size, --limit-size=limit_size
2839 Skip all files with a given size
2840 -S, --server-side-source-service-files
2841 Use server side generated sources instead of
2842 local
2843 generation.
2844 -s, --source-service-files
2845 Run local source services after update.
2846 -e, --expand-link
2847 if a package is a link, update to the expanded
2848 sources
2849 -u, --unexpand-link
2850 if a package is an expanded link, update to the
2851 raw
2852 _link file
2853 --linkrev=REV
2854 revision of the link target that is used during
2855 link
2856 expansion
2857 -r REV, --revision=REV
2858 update to specified revision (this option will
2859 be
2860 ignored if you are going to update the complete
2861 project or more than one package)
2862 updatepacmetafromspec (metafromspec, updatepkgmetafromspec)
2866 Update package meta information from a specfile
2867 ARG, if specified, is a package working copy.
2869 Usage:
2871 osc updatepacmetafromspec [ARGS...]
2872 Options:
2874 -h, --help show this help message and exit
2875 --specfile=FILE
2876 Path to specfile. (if you pass more than working
2877 copy
2878 this option is ignored)
2879 vc Edit the changes file
2883 osc vc [-m MESSAGE|-e] [filename[.changes]|path [file_with_com‐
2885 ment]] If no <filename> is given, exactly one *.changes or
2886 *.spec file has to be in the cwd or in path.
2887 The email address used in .changes file is read from BuildSer‐
2889 vice instance, or should be defined in oscrc [https://api.open‐
2890 suse.org/] user = login pass = password email =
2891 user@defined.email
2892 or can be specified via mailaddr environment variable.
2894 Usage:
2896 osc vc [ARGS...]
2897 Options:
2899 -h, --help show this help message and exit
2900 -e, --just-edit
2901 just open changes (cannot be used with -m)
2902 -F FILE, --file=FILE
2903 read changes message from FILE (do not open an
2904 editor)
2905 -m MESSAGE, --message=MESSAGE
2906 add MESSAGE to changes (do not open an editor)
2907 whatdependson
2911 Show the packages that require the specified package during the
2912 build.
2913 The command whatdependson can be used to find out what will be
2915 triggered when a certain package changes.
2916 This is no guarantee, since the new build might have changed
2918 dependencies.
2919 The arguments REPOSITORY and ARCH can be taken from the first
2921 two columns of the 'osc repos' output.
2922 usage in package or project directory:
2924 osc whatdependson REPOSITORY ARCH
2925 usage:
2927 osc whatdependson PROJECT [PACKAGE] REPOSITORY ARCH
2928 whois (user, who)
2932 Show fullname and email of a buildservice user
2933 Usage:
2935 osc whois [USERNAMES...]
2936 wipebinaries (unpublish)
2940 Delete all binary packages of a certain project/package
2941 With the optional argument <package> you can specify a certain
2943 package otherwise all binary packages in the project will be
2944 deleted.
2945 usage:
2947 osc wipebinaries OPTS # works in
2948 checked out project dir
2949 osc wipebinaries OPTS PROJECT [PACKAGE]
2950 osc unpublish OPTS # works in checked
2951 out project dir
2952 osc unpublish OPTS PROJECT [PACKAGE] Options:
2953 -h, --help show this help message and exit
2954 --all Delete all binaries regardless of the package
2955 status
2956 (previously default)
2957 --unresolvable
2958 Delete all binaries of packages which have
2959 dependency
2960 errors
2961 --broken Delete all binaries of packages for which the
2962 package
2963 source is bad
2964 --build-failed
2965 Delete all binaries of packages for which the
2966 build
2967 failed
2968 --build-disabled
2969 Delete all binaries of packages for which the
2970 build is
2971 disabled
2972 -r REPO, --repo=REPO
2973 Delete all binary packages for a specific repos‐
2974 itory
2975 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2976 AGE
2977 Delete all binary packages for specified multi‐
2978 build
2979 package
2980 -a ARCH, --arch=ARCH
2981 Delete all binary packages for a specific archi‐
2982 tecture
2983 workerinfo
2987 gets the information to a worker from the server
2988 Examples:
2990 osc workerinfo <workername>
2991 Usage:
2993 osc workerinfo WORKER
2994 GLOBAL OPTIONS
2999 Options:
3000 --version show program's version number and exit
3001 -h, --help show this help message and exit
3002 --debugger jump into the debugger before executing any‐
3003 thing
3004 --post-mortem jump into the debugger in case of errors
3005 -t, --traceback print call trace in case of errors
3006 -H, --http-debug debug HTTP traffic (filters some headers)
3007 --http-full-debug debug HTTP traffic (filters no headers)
3008 -d, --debug print info useful for debugging
3009 -A URL/alias, --apiurl=URL/alias
3010 specify URL to access API server at or an alias
3011 -c FILE, --config=FILE
3012 specify alternate configuration file
3013 --no-keyring disable usage of desktop keyring system
3014 --no-gnome-keyring disable usage of GNOME Keyring
3015 -v, --verbose increase verbosity
3016 -q, --quiet be quiet, not verbose
3017
3021 Type 'osc help <subcommand>' for more detailed help on a specific sub‐
3022 command.
3023 For additional information, see
3025 * http://en.opensuse.org/openSUSE:Build_Service_Tutorial
3026 * http://en.opensuse.org/openSUSE:OSC
3027 You can modify osc commands, or roll your own, via the plugin API:
3029 * http://en.opensuse.org/openSUSE:OSC_plugins
3030
3032 osc was written by several authors. This man page is automatically gen‐
3033 erated.
3034osc 0.169.1 Jul 2020 OSC(1)