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 up‐
25 grades.
26 usage:
28 osc add URL [URL...]
29 osc add FILE [FILE...] Options:
30 -h, --help show this help message and exit
31 -f, --force
32 add files even if they are excluded by the
33 exclude_glob config option
34 addchannels
38 Add channels to project.
39 The command adds all channels which are defined to be used for a
41 given source package. The source link target is used to lookup
42 the channels. The command can be used for a certain package or
43 for all in the specified project.
44 In case no channel is defined the operation is just returning.
46 Examples:
48 osc addchannels [PROJECT [PACKAGE]] Options:
49 -h, --help show this help message and exit
50 -e, --enable-all
51 Enable all added channels including the ones
52 disabled
53 by default.
54 -s, --skip-disabled
55 Skip disabled channels. Otherwise the source
56 gets
57 added, but not the repositories.
58 addcontainers
62 Add maintained containers for a give package
63 The command adds all containers which are marked as maintained
65 and contain an rpm originating from the specified source pack‐
66 age.
67 Examples:
69 osc addcontainers [PROJECT PACKAGE] Options:
70 -h, --help show this help message and exit
71 --extend-package-names
72 Extend packages names with project name as suf‐
73 fix
74 addremove (ar)
78 Adds new files, removes disappeared files
79 Adds all files new in the local copy, and removes all disap‐
81 peared files.
82 ARG, if specified, is a package working copy.
84 Usage:
86 osc addremove [ARGS...]
87 Options:
89 -h, --help show this help message and exit
90 -r, --recursive
91 If CWD is a project dir then scan all package
92 dirs as
93 well
94 aggregatepac
98 "Aggregate" a package to another package
99 Aggregation of a package means that the build results (binaries)
101 of a package are basically copied into another project. This
102 can be used to make packages available from building that are
103 needed in a project but available only in a different project.
104 Note that this is done at the expense of disk space. See
105 http://en.opensuse.org/openSUSE:Build_Ser‐
106 vice_Tips_and_Tricks#link_and_aggregate for more information.
107 The DESTPAC name is optional; the source packages' name will be
109 used if DESTPAC is omitted.
110 usage:
112 osc aggregatepac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Op‐
113 tions:
114 -h, --help show this help message and exit
115 -d, --disable-publish
116 disable publishing of the aggregated package
117 -m SRC=TARGET[,SRC=TARGET], --map-repo=SRC=TARGET[,SRC=TAR‐
118 GET]
119 Allows repository mapping(s) to be given as
120 SRC=TARGET[,SRC=TARGET]
121 --nosources
122 ignore source packages when copying build re‐
123 sults to
124 destination project
125 api Issue an arbitrary request to the API
129 Useful for testing.
131 URL can be specified either partially (only the path component),
133 or fully with URL scheme and hostname ('http://...').
134 Note the global -A and -H options (see osc help).
136 Examples:
138 osc api /source/home:user
139 osc api -X PUT -T /etc/fstab source/home:user/test5/myfstab
140 osc api -e /configuration
141 Usage:
143 osc api URL
144 Options:
146 -h, --help show this help message and exit
147 -a NAME STRING, --add-header=NAME STRING
148 add the specified header to the request
149 -T FILE, -f FILE, --file=FILE
150 specify filename to upload, uses PUT mode by de‐
151 fault
152 -d STRING, --data=STRING
153 specify string data for e.g. POST
154 -e, --edit GET, edit and PUT the location
155 -X HTTP_METHOD, -m HTTP_METHOD, --method=HTTP_METHOD
156 specify HTTP method to use (GET|PUT|DELETE|POST)
157 branch (bco, branchco, getpac)
161 Branch a package
162 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
164 for information on this topic.]
165 Create a source link from a package of an existing project to a
167 new subproject of the requesters home project (home:branches:)
168 The branched package will live in
170 home:USERNAME:branches:PROJECT/PACKAGE if nothing else spec‐
171 ified.
172 With getpac or bco, the branched package will come from one of
174 openSUSE:Factory (list of projects from oscrc:getpac_de‐
175 fault_project) if nothing else is specfied on the command line.
176 In case of branch errors, where the source has currently merge
178 conflicts use --linkrev=base option.
179 usage:
181 osc branch
182 osc branch SOURCEPROJECT SOURCEPACKAGE
183 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT
184 osc branch SOURCEPROJECT SOURCEPACKAGE TARGETPROJECT TARGET‐
185 PACKAGE
186 osc getpac SOURCEPACKAGE
187 osc bco ... Options:
188 -h, --help show this help message and exit
189 --add-repositories-rebuild=add_repositories_rebuild
190 specify the used rebuild strategy for new repos‐
191 itories
192 --add-repositories-block=add_repositories_block
193 specify the used block strategy for new reposi‐
194 tories
195 --linkrev=linkrev
196 specify the used revision in the link target.
197 -r rev, --revision=rev
198 branch against a specific revision
199 -N, --new-package
200 create a branch pointing to a not yet existing
201 package
202 -M, --maintenance
203 Create project and package in maintenance mode
204 -m TEXT, --message=TEXT
205 specify message TEXT
206 --noaccess Create a hidden project
207 --extend-package-names
208 Extend packages names with project name as suf‐
209 fix
210 --add-repositories
211 Add repositories to target project (happens by
212 default
213 when project is new)
214 -f, --force
215 force branch, overwrite target
216 -c, --checkout
217 Checkout branched package afterwards using "co
218 -e
219 -S"('osc bco' is a shorthand for this option)
220 --nodevelproject
221 do not follow a defined devel project (primary
222 project
223 where a package is developed)
224 browse opens browser
228 usage:
230 osc browse [PROJECT [PACKAGE]]
231 build (chroot, shell, wipe)
235 Build a package on your local machine
236 You need to call the command inside a package directory, which
238 should be a buildsystem checkout. (Local modifications are
239 fine.)
240 The arguments REPOSITORY and ARCH can be taken from the first
242 two columns of the 'osc repos' output. BUILD_DESCR is either a
243 RPM spec file, or a Debian dsc file.
244 The command honors packagecachedir, build-root and build-uid
246 settings in oscrc, if present. You may want to set su-wrapper =
247 'sudo' in oscrc, and configure sudo with option NOPASSWD for
248 /usr/bin/build.
249 If neither --clean nor --noinit is given, build will reuse an
251 existing build-root again, removing unneeded packages and add
252 missing ones. This is usually the fastest option.
253 If the package doesn't exist on the server please use the --lo‐
255 cal-package option. If the project of the package doesn't exist
256 on the server please use the --alternative-project <alternative-
257 project> option: Example:
258 osc build [OPTS] --alternative-project openSUSE:10.3 stan‐
259 dard i586 BUILD_DESCR
260 usage:
262 osc build [OPTS] # will try to guess a
263 build environement
264 osc build [OPTS] REPOSITORY ARCH BUILD_DESCR
265 osc build [OPTS] REPOSITORY ARCH
266 osc build [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR is
267 detected automatically)
268 osc build [OPTS] ARCH (REPOSITORY = build_repository (config
269 option), BUILD_DESCR is detected automatically)
270 osc build [OPTS] BUILD_DESCR (REPOSITORY = build_repository
271 (config option), ARCH = hostarch)
272 osc build [OPTS] (REPOSITORY = build_repository (config op‐
273 tion), ARCH = hostarch, BUILD_DESCR is detected automatically)
274 For debugging purposes you can run after a build the following
276 to jump inside of of the build environemnt:
277 osc shell [OPTS] REPOSITORY ARCH
279 Run a single command inside of the build environment:
281 osc shell --shell-cmd=COMMAND [OPTS] REPOSITORY ARCH
282 OPTS may be
284 --noinit # for faster run
286 --shell-cmd=COMMAND
287 --shell-after-fail
288 --extra-pkgs=PACKAGE # install additional packages
289 To clean up the build environment run
291 osc wipe [OPTS]
293 osc wipe [OPTS] REPOSITORY ARCH
294 You may set the used VM type in oscrc already, but you can also
296 overwrite it for example with
297 --vm-type=chroot # for faster, but uncleaner and unse‐
299 cure build
300 --vm-type=kvm # for clean and secure build
301 --vm-type=qemu # for slow cross architecture build us‐
302 ing system emulator
303 # Note: # Configuration can be overridden by envvars, e.g. #
305 OSC_SU_WRAPPER overrides the setting of su-wrapper. #
306 OSC_BUILD_ROOT overrides the setting of build-root. # OSC_PACK‐
307 AGECACHEDIR overrides the setting of packagecachedir.
308 Options:
310 -h, --help show this help message and exit
311 --nopreinstallimage, --no-preinstallimage
312 Do not use preinstall images for creating the
313 build
314 root.
315 --trust-all-projects
316 trust packages from all projects
317 --host=HOST
318 perform the build on a remote server -
319 user@server:~/remote/directory
320 -f, --force
321 Do not ask for confirmation to wipe
322 --shell-cmd=COMMAND
323 run specified command instead of bash
324 --shell-after-fail
325 run a shell if the build tool fails
326 --oldpackages=DIR
327 take previous build from DIR (special values:
328 _self,
329 _link)
330 --download-api-only
331 only fetch packages from the api
332 --disable-cpio-bulk-download
333 disable downloading packages as cpio archive
334 from api
335 --release=N
336 set release number of the package to N
337 -b, --baselibs
338 Create -32bit/-64bit/-x86 rpms for other archi‐
339 tectures
340 --disable-debuginfo
341 disable build of debuginfo packages
342 -d, --debuginfo
343 also build debuginfo sub-packages
344 --alternative-project=PROJECT
345 specify the build target project
346 --target=TARGET
347 define target platform
348 --vm-telnet=TELNET
349 Launch a telnet server inside of VM build
350 --vm-type=TYPE
351 use VM type TYPE (e.g. kvm)
352 --vm-disk-size=DISKSIZE
353 size for newly created disk image in MB
354 --vm-memory=MEMORY
355 amount of memory for VM defined in MB
356 --linksources
357 use hard links instead of a deep copied source
358 --stage=STAGE
359 runs a specific stage, default is "a" for all.
360 Append
361 a trailing "="to only run the specified stage.
362 Append
363 a trailing "+" to runthe specified stage and all
364 stages coming after it. With nosuffix, stages up
365 to
366 and included the specified stage are run.
367 --local-package
368 build a package which does not exist on the
369 server
370 --build-uid=uid:gid|"caller"
371 specify the numeric uid:gid pair to assign to
372 the
373 unprivileged "abuild" user or use "caller" to
374 use the
375 current user uid:gid
376 --userootforbuild, --login-as-root
377 Run build or shell as root. The default is to
378 build as
379 unprivileged user. Note that a line "# noroot‐
380 forbuild"
381 in the spec file will invalidate this option.
382 --build-opt=OPT
383 pass option OPT to the build command
384 --define='X Y'
385 define macro X with value Y
386 --without=X
387 disable feature X for build
388 --with=X enable feature X for build
389 --sccache-uri=redis://127.0.0.1:6389
390 Optional remote URI for sccache storage. Implies
391 --sccache.
392 --sccache use sccache to speed up rebuilds. Conflicts with
393 --cache
394 --pkg-ccache=/path/to/_ccache.tar
395 path to an existing uncompressed archive ccache.
396 Using
397 this option implies --ccache
398 --ccache use ccache to speed up rebuilds
399 --icecream=N
400 use N parallel build jobs with icecream
401 -t N, --threads=N
402 Compile with N threads
403 -j N, --jobs=N
404 Compile with N jobs
405 --root=ROOT
406 Build in specified directory
407 -x PAC, --extra-pkgs=PAC
408 Add this package when installing the build-root
409 -M MPAC, --multibuild-package=MPAC
410 Build the specified multibuild package
411 -k DIR, --keep-pkgs=DIR
412 Save built packages into this directory
413 -p DIR, --prefer-pkgs=DIR
414 Prefer packages from this directory when in‐
415 stalling
416 the build-root
417 --noservice, --no-service
418 Skip run of local source services as specified
419 in
420 _service file.
421 --nodebugpackages, --no-debug-packages
422 Skip installation of additional debug packages
423 for CLI
424 builds
425 --no-verify, --noverify
426 Skip signature verification (via pgp keys) of
427 packages
428 used for build. (Global config in oscrc: no_ver‐
429 ify)
430 --nochecks, --no-checks
431 Do not run build checks on the resulting pack‐
432 ages.
433 --noinit, --no-init
434 Skip initialization of build root and start with
435 build
436 immediately.
437 --overlay=OVERLAY
438 Copy overlay filesystem to buildroot after in‐
439 stalling
440 all RPMs .
441 --rsync-dest=RSYNCDESTPATH
442 Copy folder to buildroot after installing all
443 RPMs.
444 Use together with --rsync-src. This is the path
445 on the
446 TARGET filesystem e.g.
447 /usr/src/packages/BUILD/linux-2.6 .
448 --rsync-src=RSYNCSRCPATH
449 Copy folder to buildroot after installing all
450 RPMs.
451 Use together with --rsync-dest. This is the path
452 on
453 the HOST filesystem e.g. /tmp/linux-kernel-tree.
454 It
455 defines RSYNCDONE 1 .
456 --no-changelog
457 don't update the package changelog from a
458 changes file
459 -l, --preload
460 Preload all files into the cache for offline op‐
461 eration
462 -o, --offline
463 Start with cached prjconf and packages without
464 contacting the api server
465 --clean Delete old build root before initializing it
466 buildconfig
470 Shows the build config
471 Shows the build configuration which is used in building a pack‐
473 age. This command is mostly used internally by the 'build' com‐
474 mand.
475 The returned data is the project-wide build configuration in a
477 format which is directly readable by the build script. It con‐
478 tains RPM macros and BuildRequires expansions, for example.
479 The argument REPOSITORY an be taken from the first column of the
481 'osc repos' output.
482 usage:
484 osc buildconfig REPOSITORY (in pkg or
485 prj dir)
486 osc buildconfig PROJECT REPOSITORY
487 buildhistory (buildhist)
490 Shows the build history of a package
491 The arguments REPOSITORY and ARCH can be taken from the first
493 two columns of the 'osc repos' output.
494 usage:
496 osc buildhist REPOSITORY ARCHITECTURE
497 osc buildhist PROJECT PACKAGE REPOSITORY ARCHITECTURE Op‐
498 tions:
499 -h, --help show this help message and exit
500 -M MPAC, --multibuild-package=MPAC
501 Show the buildhistory of the specified multi‐
502 build
503 package
504 -l limit, --limit=limit
505 for setting the number of results
506 --csv generate output in CSV (separated by |)
507 buildinfo
511 Shows the build info
512 Shows the build "info" which is used in building a package.
514 This command is mostly used internally by the 'build' subcom‐
515 mand. It needs to be called from within a package directory.
516 The BUILD_DESCR argument is optional. BUILD_DESCR is a local RPM
518 specfile or Debian "dsc" file. If specified, it is sent to the
519 server, and the buildinfo will be based on it. If the argument
520 is not supplied, the buildinfo is derived from the specfile
521 which is currently on the source repository server.
522 The returned data is XML and contains a list of the packages
524 used in building, their source, and the expanded BuildRequires.
525 The arguments REPOSITORY and ARCH are optional. They can be
527 taken from the first two columns of the 'osc repos' output. If
528 not specified, REPOSITORY defaults to the 'build_repository'
529 config entry in your 'oscrc' and ARCH defaults to your host ar‐
530 chitecture.
531 usage:
533 in a package working copy:
534 osc buildinfo [OPTS] REPOSITORY ARCH BUILD_DESCR
535 osc buildinfo [OPTS] REPOSITORY (ARCH = hostarch,
536 BUILD_DESCR is detected automatically)
537 osc buildinfo [OPTS] ARCH (REPOSITORY = build_repository
538 (config option), BUILD_DESCR is detected automatically)
539 osc buildinfo [OPTS] BUILD_DESCR (REPOSITORY =
540 build_repository (config option), ARCH = hostarch)
541 osc buildinfo [OPTS] (REPOSITORY = build_repository
542 (config option), ARCH = hostarch, BUILD_DESCR is detected auto‐
543 matically)
544 Note: if BUILD_DESCR does not exist locally the remote
545 BUILD_DESCR is used
546 osc buildinfo [OPTS] PROJECT PACKAGE REPOSITORY ARCH
548 [BUILD_DESCR]
549 Options:
551 -h, --help show this help message and exit
552 -p DIR, --prefer-pkgs=DIR
553 Prefer packages from this directory when in‐
554 stalling
555 the build-root
556 -x PAC, --extra-pkgs=PAC
557 Add this package when computing the buildinfo
558 -M MPAC, --multibuild-package=MPAC
559 Show the buildinfo of the specified multibuild
560 package
561 --alternative-project=PROJECT
562 specify the build target project
563 -d, --debug
564 verbose output of build dependencies
565 buildlog (bl, blt, buildlogtail)
569 Shows the build log of a package
570 Shows the log file of the build of a package. Can be used to
572 follow the log while it is being written. Needs to be called
573 from within a package directory.
574 When called as buildlogtail (or blt) it just shows the end of
576 the logfile. This is useful to see just a build failure rea‐
577 sons.
578 The arguments REPOSITORY and ARCH are the first two columns in
580 the 'osc results' output. If the buildlog url is used buildlog
581 command has the same behavior as remotebuildlog.
582 Usage:
584 osc buildlog [ARGS...]
585 [REPOSITORY ARCH | BUILDLOGURL] Options:
587 -h, --help show this help message and exit
588 -s, --strip-time
589 strip leading build time from the log
590 -o OFFSET, --offset=OFFSET
591 get log start or end from the offset
592 -M MPAC, --multibuild-package=MPAC
593 get log of the specified multibuild package
594 --lastsucceeded, --last-succeeded
595 Show the last succeeded log file
596 -l, --last Show the last finished log file
597 cat (blame, less)
601 Output the content of a file to standard output
602 Examples:
604 osc cat file
605 osc cat project package file
606 osc cat project/package/file
607 osc cat http://api.opensuse.org/build/.../_log
608 osc cat http://api.opensuse.org/source/../_link
609 osc less file
611 osc less project package file
612 osc blame file
614 osc blame project package file
615 Usage:
617 osc cat [ARGS...]
618 Options:
620 -h, --help show this help message and exit
621 -M, --meta list meta data files
622 -D, --deleted
623 access file in a deleted package
624 -u, --unexpand
625 always work with unexpanded packages.
626 -e, --expand
627 (default) force expansion of linked packages.
628 -r rev, --revision=rev
629 print out the specified revision
630 changedevelrequest (changedevelreq, cr)
634 Create request to change the devel package definition.
635 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
637 for information on this topic.]
638 See the "request" command for showing and modifying existing re‐
640 quests.
641 osc changedevelrequest PROJECT PACKAGE DEVEL_PROJECT [DE‐
643 VEL_PACKAGE]
644 checkconstraints
647 check the constraints and view compliant workers
648 Checks the constraints for compliant workers.
650 usage:
652 remote request:
653 osc checkconstraints [OPTS] PROJECT PACKAGE REPOSITORY
654 ARCH
655 in a package working copy:
657 osc checkconstraints [OPTS] REPOSITORY ARCH CONSTRAINTS‐
658 FILE
659 osc checkconstraints [OPTS] CONSTRAINTSFILE
660 osc checkconstraints [OPTS]
661 Options:
663 -h, --help show this help message and exit
664 --ignore-file
665 ignore _constraints file and only check project
666 constraints
667 checkout (co)
671 Check out content from the repository
672 Check out content from the repository server, creating a local
674 working copy.
675 When checking out a single package, the option --revision can be
677 used to specify a revision of the package to be checked out.
678 When a package is a source link, then it will be checked out in
680 expanded form. If --unexpand-link option is used, the checkout
681 will instead produce the raw _link file plus patches.
682 usage:
684 osc co PROJECT [PACKAGE] [FILE]
685 osc co PROJECT # entire project
686 osc co PROJECT PACKAGE # a package
687 osc co PROJECT PACKAGE FILE # single file -> to
688 current dir
689 while inside a project directory:
691 osc co PACKAGE # check out PACKAGE
692 from project
693 with the result of rpm -q --qf '%{DISTURL}0 PACKAGE
695 osc co obs://API/PROJECT/PLATFORM/REVISION-PACKAGE
696 Options:
698 -h, --help show this help message and exit
699 -l limit_size, --limit-size=limit_size
700 Skip all files with a given size
701 -S, --server-side-source-service-files
702 Use server side generated sources instead of lo‐
703 cal
704 generation.
705 -s, --source-service-files
706 Run source services.
707 -o outdir, --output-dir=outdir
708 place package in the specified directory instead
709 of a
710 PROJECT/PACKAGE directory
711 -c, --current-dir
712 place PACKAGE folder in the current directory
713 instead
714 of a PROJECT/PACKAGE directory
715 -M, --meta checkout out meta data instead of sources
716 -u, --unexpand-link
717 if a package is a link, check out the _link file
718 instead of the expanded sources
719 -D, --deleted
720 checkout an already deleted package. No meta
721 information
722 -e, --expand-link
723 if a package is a link, check out the expanded
724 sources
725 (no-op, since this became the default)
726 -r rev, --revision=rev
727 checkout the specified revision. NOTE: if you
728 checkout
729 the complete project this option is ignored!
730 clean removes all untracked files from the package working copy
734 Examples:
736 osc clean <path>
737 Note: if <path> is omitted it defaults to '.' (<path> has to
739 be a package working copy)
740 Warning: This command removes all files with status '?'.
742 Usage:
744 osc clean [ARGS...]
745 Options:
747 -h, --help show this help message and exit
748 -n, --dry-run
749 print the results without actually removing a
750 file
751 comment
755 List / create / delete comments
756 On create:
758 If -p is given a reply to the ID is created. Otherwise
759 a toplevel comment is created.
760 If -c is not given the default editor will be opened and
761 you can type your comment
762 usage:
764 osc comment list package PROJECT PACKAGE
765 osc comment list project PROJECT
766 osc comment list request REQUEST_ID
767 osc comment create [-p PARENT_ID] [-c COMMENT] package
769 PROJECT PACKAGE
770 osc comment create [-p PARENT_ID] [-c COMMENT] project
771 PROJECT
772 osc comment create [-p PARENT_ID] [-c COMMENT] request RE‐
773 QUEST_ID
774 osc comment delete ID
776 commit (checkin, ci)
780 Upload content to the repository server
781 Upload content which is changed in your working copy, to the
783 repository server.
784 examples:
786 osc ci # current dir
787 osc ci <dir>
788 osc ci file1 file2 ...
789 Usage:
791 osc commit [ARGS...]
792 Options:
794 -h, --help show this help message and exit
795 --skip-local-service-run, --noservice
796 Skip service run of configured source services
797 for
798 local run
799 -v, --verbose
800 Run the source services with verbose information
801 --skip-validation
802 deprecated, don't use it
803 -f, --force
804 force commit, even if there were no changes
805 -F FILE, --file=FILE
806 read log message from FILE, '-' denotes standard
807 input.
808 -n, --no-message
809 do not specify a log message
810 -m TEXT, --message=TEXT
811 specify log message TEXT
812 config get/set a config option
816 Examples:
818 osc config section option (get current value)
819 osc config section option value (set to value)
820 osc config section option --delete (delete option/reset to
821 the default)
822 osc config section --change-password (changes the password
823 in section "section")
824 (section is either an apiurl or an alias or 'general')
825 osc config --dump (dump the complete configuration)
826 Usage:
828 osc config [ARGS...]
829 Options:
831 -h, --help show this help message and exit
832 --dump-full
833 dump the complete configuration (including
834 'pass' and
835 'passx' options)
836 --dump dump the complete configuration (without 'pass'
837 and
838 'passx' options)
839 --no-echo prompt for a value but do not echo entered char‐
840 acters
841 --select-password-store
842 Change the password store
843 --change-password
844 Change password
845 -p, --prompt
846 prompt for a value
847 -s, --stdin
848 indicates that the config value should be read
849 from
850 stdin
851 -d, --delete
852 delete option from config or reset option to the
853 default)
854 copypac
858 Copy a package
859 A way to copy package to somewhere else.
861 It can be done across buildservice instances, if the -t option
863 is used. In that case, a client-side copy and link expansion
864 are implied.
865 Using --client-side-copy always involves downloading all files,
867 and uploading them to the target.
868 The DESTPAC name is optional; the source packages' name will be
870 used if DESTPAC is omitted.
871 usage:
873 osc copypac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
874 -h, --help show this help message and exit
875 -e, --expand
876 if the source package is a link then copy the
877 expanded
878 version of the link
879 -m TEXT, --message=TEXT
880 specify message TEXT
881 -t URL, --to-apiurl=URL
882 URL of destination api server. Default is the
883 source
884 api server.
885 -r rev, --revision=rev
886 copy the specified revision.
887 -d, --keep-develproject
888 keep develproject tag in the package metadata
889 -K, --keep-link
890 If the target package is a link, the link is
891 kept, but
892 may be updated. If the source package is a link,
893 its
894 expanded version is considered.
895 -k, --keep-maintainers
896 keep original maintainers. Default is remove all
897 and
898 replace with the one calling the script.
899 -c, --client-side-copy
900 do a (slower) client-side copy
901 createincident
905 Create a maintenance incident
906 [See http://openbuildservice.org/help/manuals/obs-reference-
908 guide/cha.obs.maintenance_setup.html for information on this
909 topic.]
910 This command is asking to open an empty maintenance incident.
912 This can usually only be done by a responsible maintenance team.
913 Please see the "mbranch" command on how to full such a project
914 content and the "patchinfo" command how add the required mainte‐
915 nance update information.
916 usage:
918 osc createincident [ MAINTENANCEPROJECT ] Options:
919 -h, --help show this help message and exit
920 -m TEXT, --message=TEXT
921 specify message TEXT
922 --noaccess Create a hidden project
923 -a ATTRIBUTE, --attribute=ATTRIBUTE
924 Use this attribute to find default maintenance
925 project
926 (default is OBS:MaintenanceProject)
927 createrequest (creq)
931 create multiple requests with a single command
932 usage:
934 osc creq [OPTIONS] [
935 -a submit SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
936 -a delete PROJECT [PACKAGE]
937 -a change_devel PROJECT PACKAGE DEVEL_PROJECT [DE‐
938 VEL_PACKAGE]
939 -a add_me ROLE PROJECT [PACKAGE]
940 -a add_group GROUP ROLE PROJECT [PACKAGE]
941 -a add_role USER ROLE PROJECT [PACKAGE]
942 -a set_bugowner USER PROJECT [PACKAGE]
943 ]
944 Option -m works for all types of request, the rest work only
946 for submit. example:
947 osc creq -a submit -a delete home:someone:branches:open‐
948 SUSE:Tools -a change_devel openSUSE:Tools osc home:some‐
949 one:branches:openSUSE:Tools -m ok
950 This will submit all modified packages under current direc‐
952 tory, delete project home:someone:branches:openSUSE:Tools and
953 change the devel project to home:someone:branches:openSUSE:Tools
954 for package osc in project openSUSE:Tools. Options:
955 -h, --help show this help message and exit
956 --yes proceed without asking.
957 --no-update
958 never touch source package on accept (will break
959 source links)
960 --no-cleanup
961 never remove source package on accept, but up‐
962 date its
963 content
964 --cleanup remove package if submission gets accepted (de‐
965 fault
966 for home:<id>:branch projects)
967 --nodevelproject
968 do not follow a defined devel project (primary
969 project
970 where a package is developed)
971 -s REQUEST_ID, --supersede=REQUEST_ID
972 Superseding another request by this one
973 -r REV, --revision=REV
974 for "create", specify a certain source revision
975 ID
976 (the md5 sum)
977 -m TEXT, --message=TEXT
978 specify message TEXT
979 -a, --action
980 specify action type of a request, can be :
981 submit/delete/change_devel/add_role/set_bugowner
982 delete (del, remove, rm)
986 Mark files or package directories to be deleted upon the next
987 'checkin'
988 usage:
990 cd .../PROJECT/PACKAGE
991 osc delete FILE [...]
992 cd .../PROJECT
993 osc delete PACKAGE [...]
994 This command works on check out copies. Use "rdelete" for work‐
996 ing on server side only. This is needed for removing the entire
997 project.
998 As a safety measure, projects must be empty (i.e., you need to
1000 delete all packages first).
1001 If you are sure that you want to remove a package and all its
1003 files use '--force' switch. Sometimes this also works without
1004 --force.
1005 Options:
1007 -h, --help show this help message and exit
1008 -f, --force
1009 forces removal of entire package and its files
1010 deleterequest (deletereq, dr, dropreq, droprequest)
1014 Request to delete (or 'drop') a package or project
1015 usage:
1017 osc deletereq [-m TEXT] # works in
1018 checked out project/package
1019 osc deletereq [-m TEXT] PROJECT PACKAGE
1020 osc deletereq [-m TEXT] PROJECT [--all|--repository REPOSI‐
1021 TORY] Options:
1022 -h, --help show this help message and exit
1023 --accept-in-hours=HOURS
1024 specify time when request shall get accepted
1025 automatically. Only works with write permissions
1026 in
1027 target.
1028 --all deletes entire project with packages inside
1029 -r REPOSITORY, --repository=REPOSITORY
1030 specify repository
1031 -m TEXT, --message=TEXT
1032 specify message TEXT
1033 dependson
1037 dependson shows the build dependencies inside of a project,
1038 valid for a given repository and architecture.
1039 The command can be used to find build dependencies (wrt. a given
1041 repository and arch) that reside in the same project. To see all
1042 build dependencies use the buildinfo command.
1043 This is no guarantee, since the new build might have changed de‐
1045 pendencies.
1046 NOTE: to see all binary packages, which can trigger a build you
1048 need to
1049 refer the buildinfo, since this command shows only the de‐
1050 pendencies
1051 inside of a project.
1052 The arguments REPOSITORY and ARCH can be taken from the first
1054 two columns of the 'osc repos' output.
1055 usage in package or project directory:
1057 osc dependson REPOSITORY ARCH
1058 usage:
1060 osc dependson PROJECT [PACKAGE] REPOSITORY ARCH
1061 detachbranch
1065 replace a link with its expanded sources
1066 If a package is a link it is replaced with its expanded sources.
1068 The link does not exist anymore.
1069 usage:
1071 osc detachbranch # can be used in package
1072 working copy
1073 osc detachbranch PROJECT PACKAGE Options:
1074 -h, --help show this help message and exit
1075 -m TEXT, --message=TEXT
1076 specify message TEXT
1077 develproject (bsdevelproject, dp)
1081 print the devel project / package of a package
1082 Examples:
1084 osc develproject PRJ PKG
1085 osc develproject Options:
1086 -h, --help show this help message and exit
1087 -r, --raw deprecated option
1088 diff (di, ldiff, linkdiff)
1092 Generates a diff
1093 Generates a diff, comparing local changes against the repository
1095 server.
1096 Usage:
1098 osc diff [ARGS...]
1099 ARG, if specified, is a filename to include in the diff.
1101 Default: all files.
1102 osc diff --link
1104 osc linkdiff
1105 Compare current checkout directory against the link
1106 base.
1107 osc diff --link PROJ PACK
1109 osc linkdiff PROJ PACK
1110 Compare a package against the link base (ignoring work‐
1111 ing copy changes).
1112 Options:
1114 -h, --help show this help message and exit
1115 -u, --unexpand
1116 Local changes only, ignore changes in linked
1117 package
1118 sources
1119 --missingok
1120 do not fail if the source or target
1121 project/package
1122 does not exist on the server
1123 -l, --link (osc linkdiff): compare against the base revi‐
1124 sion of
1125 the link
1126 -p, --plain
1127 output the diff in plain (not unified) diff for‐
1128 mat
1129 -M, --meta operate on meta files
1130 -r rev1[:rev2], --revision=rev1[:rev2]
1131 If rev1 is specified it will compare your work‐
1132 ing copy
1133 against the revision (rev1) on the server. If
1134 rev1 and
1135 rev2 are specified it will compare rev1 against
1136 rev2
1137 (NOTE: changes in your working copy are ignored
1138 in
1139 this case)
1140 -c rev, --change=rev
1141 the change made by revision rev (like -r
1142 rev-1:rev).If
1143 rev is negative this is like -r rev:rev-1.
1144 distributions (dists)
1148 Shows all available distributions
1149 This command shows the available distributions. For active dis‐
1151 tributions it shows the name, project and name of the repository
1152 and a suggested default repository name.
1153 usage:
1155 osc distributions
1156 enablechannels (enablechannel)
1160 Enables channels
1161 Enables existing channel packages in a project. Enabling means
1163 adding the needed repositories for building. The command can be
1164 used to enable a specific one or all channels of a project.
1165 Examples:
1167 osc enablechannels [PROJECT [CHANNEL_PACKAGE]]
1168 getbinaries
1171 Download binaries to a local directory
1172 This command downloads packages directly from the api server.
1174 Thus, it directly accesses the packages that are used for build‐
1175 ing others even when they are not "published" yet.
1176 usage:
1178 osc getbinaries REPOSITORY #
1179 works in checked out project/package (check out all archs in
1180 subdirs)
1181 osc getbinaries REPOSITORY ARCHITECTURE #
1182 works in checked out project/package
1183 osc getbinaries PROJECT REPOSITORY ARCHITECTURE
1184 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE
1185 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE FILE
1186 Options:
1187 -h, --help show this help message and exit
1188 --ccache allow fetching ccache archive
1189 --debug also fetch debug packages
1190 --sources also fetch source packages
1191 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1192 AGE
1193 get binaries from specified multibuild package
1194 -d DIR, --destdir=DIR
1195 destination directory
1196 -q, --quiet
1197 do not show downloading progress
1198 help (?, h)
1202 give detailed help on a specific sub-command
1203 usage:
1205 osc help [SUBCOMMAND]
1206 importsrcpkg
1209 Import a new package from a src.rpm
1210 A new package dir will be created inside the project dir (if no
1212 project is specified and the current working dir is a project
1213 dir the package will be created in this project). If the package
1214 does not exist on the server it will be created too otherwise
1215 the meta data of the existing package will be updated (<title />
1216 and <description />). The src.rpm will be extracted into the
1217 package dir. The files won't be committed unless you explicitly
1218 pass the --commit switch.
1219 SRPM is the path of the src.rpm in the local filesystem, or an
1221 URL.
1222 Usage:
1224 osc importsrcpkg SRPM
1225 Options:
1227 -h, --help show this help message and exit
1228 -c, --commit
1229 commit the new files
1230 --delete-old-files
1231 delete existing files from the server
1232 -d description, --description=description
1233 set the description of the package
1234 -t title, --title=title
1235 set a title
1236 -n name, --name=name
1237 specify a package name
1238 -p project, --project=project
1239 specify the path to a project
1240 info Print information about a working copy
1244 Print information about each ARG (default: '.') ARG is a work‐
1246 ing-copy path.
1247 Usage:
1249 osc info [ARGS...]
1250 init Initialize a directory as working copy
1254 Initialize an existing directory to be a working copy of an (al‐
1256 ready existing) buildservice project/package.
1257 (This is the same as checking out a package and then copying
1259 sources into the directory. It does NOT create a new package. To
1260 create a package, use 'osc meta pkg ... ...')
1261 You wouldn't normally use this command.
1263 To get a working copy of a package (e.g. for building it or
1265 working on it, you would normally use the checkout command. Use
1266 "osc help checkout" to get help for it.
1267 usage:
1269 osc init PRJ
1270 osc init PRJ PAC
1271 jobhistory (jobhist)
1274 Shows the job history of a project
1275 The arguments REPOSITORY and ARCH can be taken from the first
1277 two columns of the 'osc repos' output.
1278 usage:
1280 osc jobhist REPOSITORY ARCHITECTURE (in project dir)
1281 osc jobhist PROJECT [PACKAGE] REPOSITORY ARCHITECTURE Op‐
1282 tions:
1283 -h, --help show this help message and exit
1284 -M MPAC, --multibuild-package=MPAC
1285 get jobhistory for the specified multibuild
1286 package
1287 -l limit, --limit=limit
1288 for setting the number of results
1289 --csv generate output in CSV (separated by |)
1290 linkpac
1294 "Link" a package to another package
1295 A linked package is a clone of another package, but plus local
1297 modifications. It can be cross-project.
1298 The DESTPAC name is optional; the source packages' name will be
1300 used if DESTPAC is omitted.
1301 Afterwards, you will want to 'checkout DESTPRJ DESTPAC'.
1303 To add a patch, add the patch as file and add it to the _link
1305 file. You can also specify text which will be inserted at the
1306 top of the spec file.
1307 See the examples in the _link file.
1309 NOTE: In case you want to fix or update another package, you
1311 should use the 'branch'
1312 command. A branch has correct repositories (and a link)
1313 setup up by default and
1314 will be cleaned up automatically after it was submitted
1315 back.
1316 usage:
1318 osc linkpac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
1319 -h, --help show this help message and exit
1320 -N, --new-package
1321 create a link to a not yet existing package
1322 -d, --disable-publish
1323 disable publishing of the linked package
1324 -f, --force
1325 overwrite an existing link file if it is there.
1326 -r rev, --revision=rev
1327 link the specified revision.
1328 -c, --current
1329 link fixed against current revision.
1330 -C CICOUNT, --cicount=CICOUNT
1331 cicount attribute in the link, known values are
1332 add,
1333 copy, and local, default in buildservice is cur‐
1334 rently
1335 add.
1336 linktobranch
1340 Convert a package containing a classic link with patch to a
1341 branch
1342 This command tells the server to convert a _link with or without
1344 a project.diff to a branch. This is a full copy with a _link
1345 file pointing to the branched place.
1346 usage:
1348 osc linktobranch # can be used in checked
1349 out package
1350 osc linktobranch PROJECT PACKAGE
1351 list (LL, lL, ll, ls)
1354 List sources or binaries on the server
1355 Examples for listing sources:
1357 ls # list all projects (deprecated)
1358 ls / # list all projects
1359 ls . # take PROJECT/PACKAGE from cur‐
1360 rent dir.
1361 ls PROJECT # list packages in a project
1362 ls PROJECT PACKAGE # list source files of package of
1363 a project
1364 ls PROJECT PACKAGE <file> # list <file> if this file exists
1365 ls -v PROJECT PACKAGE # verbosely list source files of
1366 package
1367 ls -l PROJECT PACKAGE # verbosely list source files of
1368 package
1369 ll PROJECT PACKAGE # verbosely list source files of
1370 package
1371 LL PROJECT PACKAGE # verbosely list source files of
1372 expanded link
1373 With --verbose, the following fields will be shown for each
1375 item:
1376 MD5 hash of file
1377 Revision number of the last commit
1378 Size (in bytes)
1379 Date and time of the last commit
1380 Examples for listing binaries:
1382 ls -b PROJECT # list all binaries of a project
1383 ls -b PROJECT -a ARCH # list ARCH binaries of a project
1384 ls -b PROJECT -r REPO # list binaries in REPO
1385 ls -b PROJECT PACKAGE REPO ARCH
1386 Usage:
1388 list (LL, lL, ll, ls) [PROJECT [PACKAGE]]
1389 list (LL, lL, ll, ls) -b [PROJECT [PACKAGE [REPO [ARCH]]]]
1390 Options:
1391 -h, --help show this help message and exit
1392 -R REVISION, --revision=REVISION
1393 specify revision (only for sources)
1394 -M, --meta list meta data files
1395 -D, --deleted
1396 show only the former deleted projects or pack‐
1397 ages
1398 -l, --long print extra information
1399 -v, --verbose
1400 print extra information
1401 -u, --unexpand
1402 always work with unexpanded (source) packages
1403 -e, --expand
1404 expand linked package (only for sources)
1405 -b, --binaries
1406 list built binaries instead of sources
1407 -r REPO, --repo=REPO
1408 specify repository (only for binaries)
1409 -a ARCH, --arch=ARCH
1410 specify architecture (only for binaries)
1411 localbuildlog (lbl)
1415 Shows the build log of a local buildchroot
1416 usage:
1418 osc lbl [REPOSITORY [ARCH]]
1419 osc lbl # show log of newest last local build
1420 Options:
1422 -h, --help show this help message and exit
1423 -s, --strip-time
1424 strip leading build time from the log
1425 -o OFFSET, --offset=OFFSET
1426 get log starting from offset
1427 lock Locks a project or package.
1431 usage:
1433 osc lock PROJECT [PACKAGE]
1434 Options:
1436 -h, --help show this help message and exit
1437 -m TEXT, --message=TEXT
1438 specify log message TEXT
1439 log Shows the commit log of a package
1443 Usage:
1445 osc log (inside working copy)
1446 osc log remote_project [remote_package]
1447 Options:
1449 -h, --help show this help message and exit
1450 -M, --meta checkout out meta data instead of sources
1451 -D, --deleted
1452 work on deleted package
1453 --xml generate output in XML
1454 --csv generate output in CSV (separated by |)
1455 -r rev, --revision=rev
1456 show log of the specified revision
1457 maintainer (bugowner)
1461 Show maintainers according to server side configuration
1462 # Search for official maintained sources in OBS instance
1464 osc maintainer BINARY_OR_PACKAGE_NAME <options>
1465 osc maintainer -U <user> <options>
1466 osc maintainer -G <group> <options>
1467 # Lookup via containers
1469 osc maintainer <options>
1470 osc maintainer PRJ <options>
1471 osc maintainer PRJ PKG <options>
1472 The tool looks up the default responsible person for a certain
1474 project or package. When using with an OBS 2.4 (or later)
1475 server it is doing the lookup for a given binary according to
1476 the server side configuration of default owners.
1477 The tool is also looking into devel packages and supports to
1479 fallback to the project in case a package has no defined main‐
1480 tainer.
1481 Please use "osc meta pkg" in case you need to know the defini‐
1483 tion in a specific container.
1484 PRJ and PKG default to current working-copy path.
1486 Usage:
1488 osc maintainer [ARGS...]
1489 Options:
1491 -h, --help show this help message and exit
1492 -m MESSAGE, --message=MESSAGE
1493 Define message as commit entry or request de‐
1494 scription
1495 -r role, --role=role
1496 Specify user role
1497 -d user, --delete=user
1498 delete a maintainer/bugowner (can be specified
1499 via
1500 --role)
1501 -G GROUP, --group=GROUP
1502 All official maintained instances for the speci‐
1503 fied
1504 GROUP
1505 -U USER, --user=USER
1506 All official maintained instances for the speci‐
1507 fied
1508 USER
1509 -S user, --set-bugowner-request=user
1510 Set the bugowner to specified person via a re‐
1511 quest (or
1512 group via group: prefix)
1513 -s user, --set-bugowner=user
1514 Set the bugowner to specified person (or group
1515 via
1516 group: prefix)
1517 -A, --all list all found entries not just the first one
1518 -a user, --add=user
1519 add a new person for given role ("maintainer" by
1520 default)
1521 -D devel_project, --devel-project=devel_project
1522 define the project where this package is primar‐
1523 ily
1524 developed
1525 -v, --verbose
1526 show more information
1527 --nodevelproject
1528 do not follow a defined devel project (primary
1529 project
1530 where a package is developed)
1531 -e, --email
1532 show email addresses instead of user names
1533 -B, --bugowner
1534 Show only the bugowner if defined, or maintainer
1535 otherwise
1536 -b, --bugowner-only
1537 Show only the bugowner
1538 maintenancerequest (mr)
1542 Create a request for starting a maintenance incident.
1543 [See http://openbuildservice.org/help/manuals/obs-reference-
1545 guide/cha.obs.maintenance_setup.html for information on this
1546 topic.]
1547 This command is asking the maintenance team to start a mainte‐
1549 nance incident based on a created maintenance update. Please see
1550 the "mbranch" command on how to create such a project and the
1551 "patchinfo" command how add the required maintenance update in‐
1552 formation.
1553 usage:
1555 osc maintenancerequest [ SOURCEPROJECT [ SOURCEPACKAGES RE‐
1556 LEASEPROJECT ] ]
1557 osc maintenancerequest .
1558 The 2nd line when issued within a package directory provides a
1560 short cut to submit a single package (the one in the current di‐
1561 rectory) from the project of this package to be submitted to the
1562 release project this package links to. This syntax is only valid
1563 when specified from a package subdirectory. Options:
1564 -h, --help show this help message and exit
1565 -s REQUEST_ID, --supersede=REQUEST_ID
1566 Superseding another request by this one
1567 --incident-project=INCIDENT_PROJECT
1568 specify incident project to merge in
1569 --incident=INCIDENT
1570 specify incident number to merge in
1571 --cleanup do remove source project on accept
1572 --no-cleanup
1573 do not remove source project on accept
1574 --enforce-branching
1575 submit from a fresh branched project
1576 --release-project=RELEASEPROJECT
1577 Specify the release project
1578 -m TEXT, --message=TEXT
1579 specify message TEXT
1580 -a ATTRIBUTE, --attribute=ATTRIBUTE
1581 Use this attribute to find default maintenance
1582 project
1583 (default is OBS:MaintenanceProject)
1584 man generates a man page
1588 usage:
1590 osc man
1591 mbranch (maintained, sm)
1594 Search or branch multiple instances of a package
1595 This command is used for searching all relevant instances of
1597 packages and creating links of them in one project. This is
1598 esp. used for maintenance updates. It can also be used to branch
1599 all packages marked before with a given attribute.
1600 [See http://en.opensuse.org/openSUSE:Build_Service_Concept_Main‐
1602 tenance for information on this topic.]
1603 The branched package will live in
1605 home:USERNAME:branches:ATTRIBUTE:PACKAGE if nothing else
1606 specified.
1607 If osc maintained or sm is issued only the relevant instances of
1609 a package will be shown. No branch will be created. This is sim‐
1610 ilar to osc mbranch --dryrun.
1611 usage:
1613 osc sm [SOURCEPACKAGE] [-a ATTRIBUTE]
1614 osc mbranch [ SOURCEPACKAGE [ TARGETPROJECT ] ] Options:
1615 -h, --help show this help message and exit
1616 --version print version of maintained package
1617 --nodevelproject
1618 do not follow a defined devel project (primary
1619 project
1620 where a package is developed)
1621 --noaccess Create a hidden project
1622 --dryrun Just simulate the action and report back the re‐
1623 sult.
1624 -u UPDATE_ATTRIBUTE, --update-project-attribute=UPDATE_AT‐
1625 TRIBUTE
1626 Use this attribute to find update projects (de‐
1627 fault is
1628 OBS:UpdateProject)
1629 -a ATTRIBUTE, --attribute=ATTRIBUTE
1630 Use this attribute to find affected packages
1631 (default
1632 is OBS:Maintained)
1633 -c, --checkout
1634 Checkout branched package afterwards ('osc bco'
1635 is a
1636 shorthand for this option)
1637 meta Show meta information, or edit it
1641 Show or edit build service metadata of type <prj|pkg|prj‐
1643 conf|user|pattern>.
1644 This command displays metadata on buildservice objects like
1646 projects, packages, or users. The type of metadata is specified
1647 by the word after "meta", like e.g. "meta prj".
1648 prj denotes metadata of a buildservice project. prjconf denotes
1650 the (build) configuration of a project. pkg denotes metadata of
1651 a buildservice package. user denotes the metadata of a user.
1652 group denotes the metadata of a group. pattern denotes instal‐
1653 lation patterns defined for a project.
1654 To list patterns, use 'osc meta pattern PRJ'. An additional ar‐
1656 gument will be the pattern file to view or edit.
1657 With the --edit switch, the metadata can be edited. Per default,
1659 osc opens the program specified by the environmental variable
1660 EDITOR with a temporary file. Alternatively, content to be saved
1661 can be supplied via the --file switch. If the argument is '-',
1662 input is taken from stdin: osc meta prjconf home:user | sed ...
1663 | osc meta prjconf home:user -F -
1664 For meta prj and prjconf updates optional commit messages can be
1666 applied with --message.
1667 When trying to edit a non-existing resource, it is created im‐
1669 plicitly.
1670 Examples:
1673 osc meta prj PRJ
1674 osc meta pkg PRJ PKG
1675 osc meta pkg PRJ PKG -e
1676 Usage:
1678 osc meta <prj|prjconf> [-r|--revision REV] ARGS...
1679 osc meta <prj|pkg|prjconf|user|group|pattern> ARGS...
1680 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1681 TEXT] -e|--edit ARGS...
1682 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1683 TEXT] -F|--file ARGS...
1684 osc meta pattern --delete PRJ PATTERN
1685 osc meta attribute PRJ [PKG [SUBPACKAGE]] [--attribute AT‐
1686 TRIBUTE] [--create [--set <value_list>]|--delete|--set
1687 <value_list>] Options:
1688 -h, --help show this help message and exit
1689 --delete delete a pattern or attribute
1690 -s ATTRIBUTE_VALUES, --set=ATTRIBUTE_VALUES
1691 set attribute values
1692 -R, --remove-linking-repositories
1693 Try to remove also all repositories building
1694 against
1695 remove ones.
1696 -c, --create
1697 create attribute without values
1698 -e, --edit edit metadata
1699 -m TEXT, --message=TEXT
1700 specify log message TEXT. For prj and prjconf
1701 meta
1702 only
1703 -r REV, --revision=REV
1704 checkout given revision instead of head revi‐
1705 sion. For
1706 prj and prjconf meta only
1707 -F FILE, --file=FILE
1708 read metadata from FILE, instead of opening an
1709 editor.
1710 '-' denotes standard input.
1711 -f, --force
1712 force the save operation, allows one to ignores
1713 some
1714 errors like depending repositories. For prj meta
1715 only.
1716 --blame show author and time of each line
1717 --attribute-project
1718 include project values, if missing in packages
1719 --attribute-defaults
1720 include defined attribute defaults
1721 -a ATTRIBUTE, --attribute=ATTRIBUTE
1722 affect only a given attribute
1723 mkpac Create a new package under version control
1727 usage:
1729 osc mkpac new_package
1730 mv Move SOURCE file to DEST and keep it under version control
1733 Usage:
1735 osc mv SOURCE DEST
1736 Options:
1738 -h, --help show this help message and exit
1739 -f, --force
1740 forces removal of entire package and its files
1741 my show waiting work, packages, projects or requests involving
1745 yourself
1746 Examples:
1748 # list all open tasks for me
1749 osc my [work]
1750 # list packages where I am bugowner
1751 osc my pkg -b
1752 # list projects where I am maintainer
1753 osc my prj -m
1754 # list request for all my projects and packages
1755 osc my rq
1756 # list requests, excluding project 'foo' and 'bar'
1757 osc my rq --exclude-project foo,bar
1758 # list requests I made
1759 osc my sr
1760 Usage:
1762 osc my [ARGS...]
1763 where TYPE is one of requests, submitrequests,
1765 projects or packages (rq, sr, prj or pkg)
1766 Options:
1768 -h, --help
1769 show this help message and exit
1770 --maintained
1771 limit search results to packages with maintained
1772 attribute set.
1773 -v, --verbose
1774 verbose listing
1775 --exclude-project=EXCLUDE_PROJECT
1776 exclude requests for specified project
1777 -U USER, --user=USER
1778 search for USER instead of yourself
1779 -a, --all
1780 all involvements
1781 -m, --maintainer
1782 restrict listing to items where the user is
1783 maintainer
1784 -b, --bugowner
1785 restrict listing to items where the user is bu‐
1786 gowner
1787 patchinfo
1791 Generate and edit a patchinfo file.
1792 A patchinfo file describes the packages for an update and the
1794 kind of problem it solves.
1795 This command either creates a new _patchinfo or updates an ex‐
1797 isting one.
1798 Examples:
1800 osc patchinfo
1801 osc patchinfo [PROJECT [PATCH_NAME]] Options:
1802 -h, --help show this help message and exit
1803 -f, --force
1804 force generation of new patchinfo file, do not
1805 update
1806 existing one.
1807 pdiff Quick alias to diff the content of a package with its parent.
1811 Usage:
1813 osc pdiff [--plain|-p] [--nomissing-ok|-n]
1814 osc pdiff [--plain|-p] [--nomissing-ok|-n] PKG
1815 osc pdiff [--plain|-p] [--nomissing-ok|-n] PRJ PKG
1816 Options:
1818 -h, --help show this help message and exit
1819 -n, --nomissingok
1820 fail if the parent package does not exist on the
1821 server
1822 -p, --plain
1823 output the diff in plain (not unified) diff for‐
1824 mat
1825 prdiff (projdiff, projectdiff)
1829 Server-side diff of two projects
1830 Compares two projects and either summarizes or outputs the dif‐
1832 ferences in full. In the second form, a project is compared
1833 with one of its branches inside a home:$USER project (the branch
1834 is treated as NEWPRJ). The home branch is optional if the cur‐
1835 rent working directory is a checked out copy of it.
1836 Usage:
1838 osc prdiff [OPTIONS] OLDPRJ NEWPRJ
1839 osc prdiff [OPTIONS] [home:$USER:branch:$PRJ]
1840 Options:
1842 -h, --help show this help message and exit
1843 -d, --diffstat
1844 show diffstat of differences
1845 -u, --unified
1846 show full unified diffs of differences
1847 -o, --show-not-in-new
1848 show packages only in the old project
1849 -n, --show-not-in-old
1850 show packages only in the new project
1851 -i REGEXP, --include=REGEXP
1852 only consider packages matching REGEXP
1853 -e REGEXP, --exclude=REGEXP
1854 skip packages matching REGEXP
1855 -r, --requests
1856 show open requests for any packages with differ‐
1857 ences
1858 prjresults (pr)
1862 Shows project-wide build results
1863 Usage:
1865 osc prjresults (inside working copy)
1866 osc prjresults PROJECT
1867 Options:
1869 -h, --help show this help message and exit
1870 --show-excluded
1871 show packages that are excluded in all repos,
1872 also
1873 hide repos that have only excluded packages
1874 -V, --vertical
1875 list packages vertically instead horizontally
1876 -r REPO, --repo=REPO
1877 show results only for specified repo(s)
1878 -a ARCH, --arch=ARCH
1879 show results only for specified architecture(s)
1880 -n EXPR, --name-filter=EXPR
1881 show only packages whose names match EXPR
1882 -s STATUS, --status-filter=STATUS
1883 show only packages with buildstatus STATUS (see
1884 legend)
1885 --xml generate output in XML
1886 -c, --csv csv output
1887 -w, --watch
1888 watch the results until all finished building,
1889 only
1890 supported with --xml
1891 -b, --brief
1892 show the result in "pkgname repo arch result"
1893 -q, --hide-legend
1894 hide the legend
1895 pull merge the changes of the link target into your working copy.
1899 rdelete
1903 Delete a project or packages on the server.
1904 As a safety measure, project must be empty (i.e., you need to
1906 delete all packages first). Also, packages must have no requests
1907 pending (i.e., you need to accept/revoke such requests first).
1908 If you are sure that you want to remove this project and all its
1909 packages use '--recursive' switch. It may still not work be‐
1910 cause other depends on it. If you want to ignore this as well
1911 use '--force' switch.
1912 usage:
1914 osc rdelete [-r] [-f] PROJECT [PACKAGE]
1915 Options:
1917 -h, --help show this help message and exit
1918 -m TEXT, --message=TEXT
1919 specify log message TEXT
1920 -f, --force
1921 deletes a project where other depends on
1922 -r, --recursive
1923 deletes a project with packages inside
1924 rdiff Server-side "pretty" diff of two packages
1928 Compares two packages (three or four arguments) or shows the
1930 changes of a specified revision of a package (two arguments)
1931 If no revision is specified the latest revision is used.
1933 usage:
1935 osc rdiff OLDPRJ OLDPAC NEWPRJ [NEWPAC]
1936 osc rdiff PROJECT PACKAGE Options:
1937 -h, --help show this help message and exit
1938 --xml show diff as xml (only for issues diff)
1939 -u, --unexpand
1940 diff unexpanded version if sources are linked
1941 --missingok
1942 do not fail if the source or target
1943 project/package
1944 does not exist on the server
1945 -c rev, --change=rev
1946 the change made by revision rev (like -r
1947 rev-1:rev).
1948 If rev is negative this is like -r rev:rev-1.
1949 -p, --plain
1950 output the diff in plain (not unified) diff for‐
1951 mat and
1952 show diff of files in archives
1953 -r N[:M], --revision=N[:M]
1954 revision id, where N = old revision and M = new
1955 revision
1956 -M, --meta diff meta data
1957 --issues-only
1958 show only issues in diff
1959 --oldpkg=OLDPKG
1960 package to compare against (deprecated, use 3
1961 argument
1962 form)
1963 --oldprj=OLDPRJ
1964 project to compare against (deprecated, use 3
1965 argument
1966 form)
1967 rebuild (rebuildpac)
1971 Trigger package rebuilds
1972 Note that it is normally NOT needed to kick off rebuilds like
1974 this, because they principally happen in a fully automatic way,
1975 triggered by source check-ins. In particular, the order in which
1976 packages are built is handled by the build service.
1977 The arguments REPOSITORY and ARCH can be taken from the first
1979 two columns of the 'osc repos' output.
1980 usage:
1982 osc rebuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]] Options:
1983 -h, --help show this help message and exit
1984 --all Rebuild all packages of entire project
1985 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1986 AGE
1987 rebuild specified multibuild package
1988 -f, --failed
1989 rebuild all failed packages
1990 -r REPO, --repo=REPO
1991 trigger rebuilds for a specific repository
1992 -a ARCH, --arch=ARCH
1993 trigger rebuilds for a specific architecture
1994 release
1998 Release sources and binaries
1999 This command is used to transfer sources and binaries without
2001 rebuilding them. It requires defined release targets set to
2002 trigger="manual". Please refer the release management chapter in
2003 the OBS book for details.
2004 usage:
2006 osc release [ SOURCEPROJECT [ SOURCEPACKAGE ] ]
2007 Options:
2009 -h, --help show this help message and exit
2010 --no-delay Don't put the release job in a queue to be run
2011 later,
2012 but immediately run it. Thus the next call to
2013 osc
2014 prjresult will reflect it. Otherwise there is no
2015 way
2016 to know if it is finished or didn't start yet.
2017 --set-release=RELEASETAG
2018 rename binaries during release using this re‐
2019 lease tag
2020 --target-repository=TARGETREPOSITORY
2021 Release only to specified repository
2022 --target-project=TARGETPROJECT
2023 Release only to specified project
2024 -r REPO, --repo=REPO
2025 Release only binaries from the specified reposi‐
2026 tory
2027 releaserequest
2031 Create a release request
2032 For maintenance incident projects:
2034 This command is used by the maintenance team to start the re‐
2036 lease process of a maintenance update. This includes usually
2037 testing based on the defined reviewers of the update project.
2038 [See https://openbuildservice.org/help/manuals/obs-user-
2040 guide/cha.obs.maintenance_setup.html
2041 for information on this topic.]
2042 For normal projects:
2044 This command is used to transfer sources and binaries without
2046 rebuilding them. It requires defined release targets set to
2047 trigger="manual".
2048 [See https://openbuildservice.org/help/manuals/obs-user-
2050 guide/cha.obs.request_and_review_system.html
2051 for information on this topic.]
2052 usage:
2054 osc releaserequest [-p package] [ SOURCEPROJECT ]
2055 Options:
2057 -h, --help show this help message and exit
2058 -p PKG, --package=PKG
2059 specify packages to release
2060 -m TEXT, --message=TEXT
2061 specify message TEXT
2062 remotebuildlog (rbl, rblt, rbuildlog, rbuildlogtail, remotebuildlog‐
2066 tail)
2067 Shows the build log of a package
2068 Shows the log file of the build of a package. Can be used to
2070 follow the log while it is being written.
2071 remotebuildlogtail shows just the tail of the log file.
2073 usage:
2075 osc remotebuildlog project package repository arch
2076 or
2077 osc remotebuildlog project/package/repository/arch
2078 or
2079 osc remotebuildlog buildlogurl Options:
2080 -h, --help show this help message and exit
2081 -s, --strip-time
2082 strip leading build time from the log
2083 -o OFFSET, --offset=OFFSET
2084 get log starting or ending from the offset
2085 -M MPAC, --multibuild-package=MPAC
2086 show log file for specified multibuild package
2087 --lastsucceeded, --last-succeeded
2088 Show the last succeeded log file
2089 -l, --last Show the last finished log file
2090 repairlink
2094 Repair a broken source link
2095 This command checks out a package with merged source changes. It
2097 uses a 3-way merge to resolve file conflicts. After review‐
2098 ing/repairing the merge, use 'osc resolved ...' and 'osc ci' to
2099 re-create a working source link.
2100 usage: * For merging conflicting changes of a checkout package:
2102 osc repairlink
2103 * Check out a package and merge changes:
2105 osc repairlink PROJECT PACKAGE
2106 * Pull conflicting changes from one project into another one:
2108 osc repairlink PROJECT PACKAGE INTO_PROJECT [INTO_PACKAGE]
2109 Options:
2111 -h, --help show this help message and exit
2112 -d DIR, --destdir=DIR
2113 destination directory
2114 repairwc
2118 try to repair an inconsistent working copy
2119 Examples:
2121 osc repairwc <path>
2122 Note: if <path> is omitted it defaults to '.' (<path> can be
2124 a project or package working copy)
2125 Warning: This command might delete some files in the storedir
2127 (.osc). Please check the state of the wc afterwards (via 'osc
2128 status').
2129 Usage:
2131 osc repairwc [ARGS...]
2132 Options:
2134 -h, --help show this help message and exit
2135 --force-apiurl
2136 ask once for an apiurl and force this apiurl for
2137 all
2138 inconsistent projects/packages
2139 repositories (platforms, repos)
2143 shows repositories configured for a project.
2144 It skips repositories by default which are dis‐
2145 abled for a given package.
2146 usage:
2148 osc repos
2149 osc repos [PROJECT] [PACKAGE]
2150 repourls
2154 Shows URLs of .repo files
2155 Shows URLs on which to access the project repositories.
2157 usage:
2159 osc repourls [PROJECT]
2160 request (review, rq)
2164 Show or modify requests and reviews
2165 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2167 for information on this topic.]
2168 The 'request' command has the following sub commands:
2170 "list" lists open requests attached to a project or package or
2172 person. Uses the project/package of the current directory if
2173 none of -M, -U USER, project/package are given.
2174 "log" will show the history of the given ID
2176 "show" will show the request itself, and generate a diff for re‐
2178 view, if used with the --diff option. The keyword show can be
2179 omitted if the ID is numeric.
2180 "decline" will change the request state to "declined"
2182 "reopen" will set the request back to new or review.
2184 "setincident" will direct "maintenance" requests into specific
2186 incidents
2187 "supersede" will supersede one request with another existing
2189 one.
2190 "revoke" will set the request state to "revoked"
2192 "accept" will change the request state to "accepted" and will
2194 trigger the actual submit process. That would normally be a
2195 server-side copy of the source package to the target package.
2196 "approve" marks a requests in "review" state as approved. This
2198 request will get accepted automatically when the last review got
2199 accepted.
2200 "checkout" will checkout the request's source package ("submit"
2202 requests only).
2203 "prioritize" change the priority of a request to either "criti‐
2205 cal", "important", "moderate" or "low"
2206 The 'review' command has the following sub commands:
2209 "list" lists open requests that need to be reviewed by the spec‐
2211 ified user or group
2212 "add" adds a person or group as reviewer to a request
2214 "accept" mark the review positive
2216 "decline" mark the review negative. A negative review will de‐
2218 cline the request.
2219 usage:
2221 osc request list [-M] [-U USER] [-s state] [-D DAYS] [-t
2222 type] [-B] [PRJ [PKG]]
2223 osc request log ID
2224 osc request [show] [-d] [-b] ID
2225 osc request accept [-m TEXT] ID
2227 osc request approve [-m TEXT] ID
2228 osc request cancelapproval [-m TEXT] ID
2229 osc request decline [-m TEXT] ID
2230 osc request revoke [-m TEXT] ID
2231 osc request reopen [-m TEXT] ID
2232 osc request setincident [-m TEXT] ID INCIDENT
2233 osc request supersede [-m TEXT] ID SUPERSEDING_ID
2234 osc request approvenew [-m TEXT] PROJECT
2235 osc request prioritize [-m TEXT] ID PRIORITY
2236 osc request checkout/co ID
2238 osc request clone [-m TEXT] ID
2239 osc review show [-d] [-b] ID
2241 osc review list [-U USER] [-G GROUP] [-P PROJECT [-p PACK‐
2242 AGE]] [-s state]
2243 osc review add [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2244 [-p PACKAGE]] ID
2245 osc review accept [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2246 [-p PACKAGE]] ID
2247 osc review decline [-m TEXT] [-U USER] [-G GROUP] [-P
2248 PROJECT [-p PACKAGE]] ID
2249 osc review reopen [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2250 [-p PACKAGE]] ID
2251 osc review supersede [-m TEXT] [-U USER] [-G GROUP] [-P
2252 PROJECT [-p PACKAGE]] ID SUPERSEDING_ID
2253 Options:
2255 -h, --help show this help message and exit
2256 --source-buildstatus
2257 print the buildstatus of the source package
2258 (only
2259 works with "show" and the interactive review)
2260 --target-package-filter=TARGET_PACKAGE_FILTER
2261 only list requests for the packages matching the
2262 package filter. A (python) regular expression is
2263 expected.
2264 --involved-projects
2265 show all requests for project/packages where
2266 USER is
2267 involved
2268 --incoming Show only requests where the project is target
2269 --exclude-target-project=EXCLUDE_TARGET_PROJECT
2270 exclude target project from request list
2271 --non-interactive
2272 non-interactive review of request
2273 --or-revoke
2274 For automation scripts: accepts (if using with
2275 accept
2276 argument) a request when it is in new or review
2277 state.
2278 Or revoke it when it got declined. Otherwise
2279 just do
2280 nothing.
2281 -i, --interactive
2282 interactive review of request
2283 -e, --edit edit a submit action
2284 -B, --bugowner
2285 also show requests about packages where I am bu‐
2286 gowner
2287 -M, --mine only show requests created by yourself
2288 -b, --brief
2289 print output in list view as list subcommand
2290 -p PACKAGE, --package=PACKAGE
2291 requests or reviews limited for the specified
2292 PACKAGE,
2293 requires also a PROJECT
2294 -P PROJECT, --project=PROJECT
2295 requests or reviews limited for the specified
2296 PROJECT
2297 -G GROUP, --group=GROUP
2298 requests or reviews limited for the specified
2299 GROUP
2300 -U USER, --user=USER
2301 requests or reviews limited for the specified
2302 USER
2303 -D DAYS, --days=DAYS
2304 only list requests in state "new" or changed in
2305 the
2306 last DAYS. [default=0]
2307 -s STATE, --state=STATE
2308 only list requests in one of the comma separated
2309 given
2310 states (new/review/accepted/revoked/declined) or
2311 "all"
2312 [default="declined,new,review", or "all", if no
2313 args
2314 given]
2315 -f, --force
2316 enforce state change, can be used to ignore open
2317 reviews
2318 -a, --all all states. Same as'-s all'
2319 -t TYPE, --type=TYPE
2320 limit to requests which contain a given action
2321 type (s
2322 ubmit/delete/change_devel/add_role/set_bu‐
2323 gowner/mainte
2324 nance_incident/maintenance_release)
2325 -m TEXT, --message=TEXT
2326 specify message TEXT
2327 --no-devel Do not attempt to forward to devel project
2328 -u, --unified
2329 output the diff in the unified diff format
2330 -d, --diff generate a diff
2331 requestmaintainership (reqbs, reqbugownership, reqmaintainership, re‐
2335 qms, requestbugownership)
2336 requests to add user as maintainer or bugowner
2337 usage:
2339 osc requestmaintainership # for
2340 current user in checked out package
2341 osc requestmaintainership USER # for
2342 specified user in checked out package
2343 osc requestmaintainership PROJECT # for
2344 current user if cwd is not a checked out package
2345 osc requestmaintainership PROJECT group:NAME # re‐
2346 quest for specified group
2347 osc requestmaintainership PROJECT PACKAGE # for
2348 current user
2349 osc requestmaintainership PROJECT PACKAGE USER # re‐
2350 quest for specified user
2351 osc requestmaintainership PROJECT PACKAGE group:NAME # re‐
2352 quest for specified group
2353 osc requestbugownership ... # ac‐
2355 cepts same parameters but uses bugowner role
2356 Options:
2358 -h, --help show this help message and exit
2359 -r role, --role=role
2360 specify user role (default: maintainer)
2361 -m TEXT, --message=TEXT
2362 specify message TEXT
2363 resolved
2367 Remove 'conflicted' state on working copy files
2368 If an upstream change can't be merged automatically, a file is
2370 put into in 'conflicted' ('C') state. Within the file, conflicts
2371 are marked with special <<<<<<< as well as ======== and >>>>>>>
2372 lines.
2373 After manually resolving all conflicting parts, use this command
2375 to remove the 'conflicted' state.
2376 Note: this subcommand does not semantically resolve conflicts
2378 or remove conflict markers; it merely removes the conflict-re‐
2379 lated artifact files and allows PATH to be committed again.
2380 usage:
2382 osc resolved FILE [FILE...]
2383 restartbuild (abortbuild)
2386 Restart the build of a certain project or package
2387 usage:
2389 osc restartbuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]] Op‐
2390 tions:
2391 -h, --help show this help message and exit
2392 --all Restart all running builds of entire project
2393 -r REPO, --repo=REPO
2394 Restart builds for a specific repository
2395 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2396 AGE
2397 Restart builds for specified multibuild package
2398 -a ARCH, --arch=ARCH
2399 Restart builds for a specific architecture
2400 results (r)
2404 Shows the build results of a package or project
2405 Usage:
2407 osc results # (inside working copy of PRJ or
2408 PKG)
2409 osc results PROJECT [PACKAGE]
2410 Options:
2412 -h, --help show this help message and exit
2413 --show-excluded
2414 show repos that are excluded for this package
2415 --format=FORMAT
2416 format string for csv output
2417 --csv generate output in CSV format
2418 --xml generate output in XML (former results_meta)
2419 -f, --failed
2420 show only failed results
2421 -s STATUS_FILTER, --status-filter=STATUS_FILTER
2422 only show packages with the given build status
2423 -w, --watch
2424 watch the results until all finished building
2425 -V, --vertical
2426 list packages vertically instead horizontally
2427 for
2428 entire project
2429 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2430 AGE
2431 Only show results for the specified multibuild
2432 package
2433 --no-multibuild
2434 Disable results for all direct affect packages
2435 inside
2436 of the project
2437 -v, --verbose
2438 more verbose output
2439 -b, --brief
2440 show the result in "pkgname repo arch result".
2441 Default
2442 for -f
2443 -a ARCH, --arch=ARCH
2444 Show results only for specified architecture(s)
2445 -r REPO, --repo=REPO
2446 Show results only for specified repo(s)
2447 -l, --last-build
2448 show last build results (succeeded/failed/un‐
2449 known)
2450 revert Restore changed files or the entire working copy.
2454 Examples:
2456 osc revert <modified file(s)>
2457 osc revert . Note: this only works for package working
2458 copies
2459 Usage:
2461 osc revert [FILES...]
2462 rpmlintlog (lint, rpmlint)
2466 Shows the rpmlint logfile
2467 Shows the rpmlint logfile to analyse if there are any problems
2469 with the spec file and the built binaries.
2470 usage:
2472 osc rpmlintlog project package repository arch
2473 rremove
2476 Remove source files from selected package
2477 Usage:
2479 osc rremove PROJECT PACKAGE [FILES...]
2480 Options:
2482 -h, --help show this help message and exit
2483 -f, --force
2484 Don't ask and delete files
2485 search (bse, se)
2489 Search for a project and/or package.
2490 If no option is specified osc will search for projects and pack‐
2492 ages which contains the 'search term' in their name, title or
2493 description.
2494 usage:
2496 osc search 'search term' <options>
2497 osc bse ... ('osc search --binary')
2498 osc se 'perl(Foo::Bar)' ('osc search --package
2499 perl-Foo-Bar') Options:
2500 -h, --help show this help message and exit
2501 --binaryversion=VERSION
2502 search for binary with specified version (im‐
2503 plies
2504 --binary)
2505 -B PROJECT, --baseproject=PROJECT
2506 search packages built for PROJECT (implies --bi‐
2507 nary)
2508 --binary search binary packages
2509 --csv generate output in CSV (separated by |)
2510 -M, --mine shorthand for --bugowner --package
2511 --maintained
2512 OBSOLETE: please use maintained command instead.
2513 -m, --maintainer
2514 as -i, but only maintainer
2515 -b, --bugowner
2516 as -i, but only bugowner
2517 -i, --involved
2518 show projects/packages where given person (or
2519 myself)
2520 is involved as bugowner or maintainer
2521 [[{group|person}/]<name>] default: person
2522 -V, --version
2523 show package version, revision, and srcmd5. CAU‐
2524 TION:
2525 This is slow and unreliable
2526 -v, --verbose
2527 show more information
2528 -a ATTRIBUTE, --limit-to-attribute=ATTRIBUTE
2529 match only when given attribute exists in meta
2530 data
2531 --description
2532 search for matches in the 'description' element
2533 --title search for matches in the 'title' element
2534 --project search for a project
2535 --package search for a package
2536 -s, --substring
2537 Show also results where the search term is a sub
2538 string, slower search
2539 -e, --exact
2540 show only exact matches, this is default now
2541 --repos-baseurl
2542 show base URLs of download repositories
2543 sendsysrq
2547 trigger a sysrq in a running build
2548 This is only going to work when the build is running in a sup‐
2550 ported VM. Also only a subset of sysrq are supported. Typical
2551 use case for debugging are 9, t and w in this sequence.
2552 usage:
2554 osc sendsysrq REPOSITORY ARCH SYSRQ
2555 osc sendsysrq PROJECT PACKAGE REPOSITORY ARCH SYSRQ Options:
2556 -h, --help show this help message and exit
2557 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2558 AGE
2559 specify a specific multibuild flavor
2560 service
2564 Handle source services
2565 Source services can be used to modify sources like downloading
2567 files, verify files, generating files or modify existing files.
2568 usage:
2570 osc service COMMAND (inside working copy)
2571 osc service run [SOURCE_SERVICE]
2572 osc service runall
2573 osc service manualrun [SOURCE_SERVICE]
2574 osc service localrun [SOURCE_SERVICE]
2575 osc service disabledrun [SOURCE_SERVICE]
2576 osc service remoterun [PROJECT PACKAGE]
2577 osc service merge [PROJECT PACKAGE]
2578 osc service wait [PROJECT PACKAGE]
2579 COMMAND can be:
2581 run r run defined services with modes "trylocal",
2582 "localonly", or no mode set locally,
2583 may take an optional parameter to run only a
2584 specified source service. In case
2585 parameters exist for this one in _service
2586 file they are used.
2587 runall ra run all services independent of the used mode
2588 manualrun mr run all services with mode "manual", may take
2589 an optional parameter to run only a
2590 specified source service
2591 remoterun rr trigger a re-run on the server side
2592 merge commits all server side generated files and
2593 drops the _service definition
2594 wait waits until the service finishes and returns
2595 with an error if it failed
2596 Not for common usage anymore:
2598 localrun lr the same as "run" but services with mode
2599 "serveronly" are also executed
2600 disabledrun dr run all services with mode "disabled"
2601 setdevelproject (sdp)
2605 Set the devel project / package of a package
2606 Examples:
2608 osc setdevelproject [PRJ PKG] DEVPRJ [DEVPKG] Options:
2609 -h, --help show this help message and exit
2610 -u, --unset
2611 remove devel project
2612 setlinkrev
2616 Updates a revision number in a source link.
2617 This command adds or updates a specified revision number in a
2619 source link. The current revision of the source is used, if no
2620 revision number is specified.
2621 usage:
2623 osc setlinkrev
2624 osc setlinkrev PROJECT [PACKAGE] Options:
2625 -h, --help show this help message and exit
2626 -u, --unset
2627 remove revision in link, it will point always to
2628 latest revision
2629 -R, --use-plain-revision
2630 Do not expand revision the specified or latest
2631 rev
2632 -r rev, --revision=rev
2633 use the specified revision.
2634 showlinked
2638 Show all packages linking to a given one
2639 Examples:
2641 osc showlinked [PROJECT PACKAGE]
2642 signkey
2645 Manage Project Signing Key
2646 osc signkey [--create|--delete|--extend] <PROJECT> osc signkey
2648 [--notraverse] <PROJECT>
2649 This command is for managing gpg keys. It shows the public key
2651 by default. There is no way to download or upload the private
2652 part of a key by design.
2653 However you can create a new own key. You may want to consider
2655 to sign the public key with your own existing key.
2656 If a project has no key, the key from upper level project will
2658 be used (e.g. when dropping "KDE:KDE4:Community" key, the one
2659 from "KDE:KDE4" will be used).
2660 WARNING: THE OLD KEY CANNOT BE RESTORED AFTER USING DELETE OR
2662 CREATE
2663 Usage:
2665 osc signkey [ARGS...]
2666 Options:
2668 -h, --help show this help message and exit
2669 --sslcert fetch SSL certificate instead of GPG key
2670 --notraverse
2671 don't traverse projects upwards to find key
2672 --delete delete the gpg signing key in this project
2673 --extend extend expiration date of the gpg public key for
2674 this
2675 project
2676 --create create new gpg signing key for this project
2677 status (st)
2681 Show status of files in working copy
2682 Show the status of files in a local working copy, indicating
2684 whether files have been changed locally, deleted, added, ...
2685 The first column in the output specifies the status and is one
2687 of the following characters:
2688 ' ' no modifications
2689 'A' Added
2690 'C' Conflicted
2691 'D' Deleted
2692 'M' Modified
2693 'R' Replaced (file was deleted and added again afterwards)
2694 '?' item is not under version control
2695 '!' item is missing (removed by non-osc command) or incomplete
2696 'S' item is skipped (item exceeds a file size limit or is
2697 _service:* file)
2698 'F' Frozen (use "osc pull" to merge conflicts) (package-only
2699 state)
2700 examples:
2702 osc st
2703 osc st <directory>
2704 osc st file1 file2 ...
2705 usage:
2707 osc status [OPTS] [PATH...] Options:
2708 -h, --help show this help message and exit
2709 -e, --show-excluded
2710 also show files which are excluded by the
2711 "exclude_glob" config option
2712 -v, --verbose
2713 print extra information
2714 -q, --quiet
2715 print as little as possible
2716 submitrequest (sr, submitpac, submitreq)
2720 Create request to submit source into another Project
2721 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2723 for information on this topic.]
2724 See the "request" command for showing and modifying existing re‐
2726 quests.
2727 usage:
2729 osc submitreq [OPTIONS]
2730 osc submitreq [OPTIONS] DESTPRJ [DESTPKG]
2731 osc submitreq [OPTIONS] SOURCEPRJ SOURCEPKG DESTPRJ
2732 [DESTPKG]
2733 osc submitpac ... is a shorthand for osc submitreq --cleanup
2735 ...
2736 Options:
2738 -h, --help show this help message and exit
2739 --yes proceed without asking.
2740 -d, --diff show diff only instead of creating the actual
2741 request
2742 --update-link
2743 This transfers the source including the _link
2744 file.
2745 --no-update
2746 never touch source package on accept (will break
2747 source links)
2748 --no-cleanup
2749 never remove source package on accept, but up‐
2750 date its
2751 content
2752 --cleanup remove package if submission gets accepted (de‐
2753 fault
2754 for home:<id>:branch projects)
2755 --seperate-requests
2756 Deprecated (wrong spelling - see --separate-re‐
2757 quests)
2758 --separate-requests
2759 Create multiple requests instead of a single one
2760 (when
2761 command is used for entire project)
2762 --nodevelproject
2763 do not follow a defined devel project (primary
2764 project
2765 where a package is developed)
2766 -s REQUEST_ID, --supersede=REQUEST_ID
2767 Superseding another request by this one
2768 -r REV, --revision=REV
2769 specify a certain source revision ID (the md5
2770 sum) for
2771 the source package
2772 -m TEXT, --message=TEXT
2773 specify message TEXT
2774 token Show and manage authentication token
2778 Authentication token can be used to run specific commands with‐
2780 out sending credentials.
2781 Usage:
2783 osc token
2784 osc token --create [--operation <OPERATION>] [<PROJECT>
2785 <PACKAGE>]
2786 osc token --delete <TOKENID>
2787 osc token --trigger <TOKENSTRING> [--operation <OPERATION>]
2788 [<PROJECT> <PACKAGE>] Options:
2789 -h, --help show this help message and exit
2790 -t TOKENSTRING, --trigger=TOKENSTRING
2791 Trigger the action of a token
2792 -o OPERATION, --operation=OPERATION
2793 Default is "runservice", but "branch", "release"
2794 or
2795 "rebuild" can also be used
2796 -d TOKENID, --delete=TOKENID
2797 Delete a token
2798 -c, --create
2799 Create a new token
2800 triggerreason (tr)
2804 Show reason why a package got triggered to build
2805 The server decides when a package needs to get rebuild, this
2807 command shows the detailed reason for a package. A brief reason
2808 is also stored in the jobhistory, which can be accessed via "osc
2809 jobhistory".
2810 Trigger reasons might be:
2812 - new build (never build yet or rebuild manually forced)
2813 - source change (e.g. on updating sources)
2814 - meta change (packages which are used for building have
2815 changed)
2816 - rebuild count sync (In case that it is configured to sync
2817 release numbers)
2818 usage in package or project directory:
2820 osc triggerreason REPOSITORY ARCH
2821 osc triggerreason PROJECT PACKAGE REPOSITORY ARCH
2822 Options:
2824 -h, --help show this help message and exit
2825 -M MPAC, --multibuild-package=MPAC
2826 get triggerreason of the specified multibuild
2827 package
2828 undelete
2832 Restores a deleted project or package on the server.
2833 The server restores a package including the sources and meta
2835 configuration. Binaries remain to be lost and will be rebuild.
2836 usage:
2838 osc undelete PROJECT
2839 osc undelete PROJECT PACKAGE [PACKAGE ...]
2840 Options:
2842 -h, --help show this help message and exit
2843 -m TEXT, --message=TEXT
2844 specify log message TEXT
2845 unlock Unlocks a project or package
2849 Unlocks a locked project or package. A comment is required.
2851 usage:
2853 osc unlock PROJECT [PACKAGE]
2854 Options:
2856 -h, --help show this help message and exit
2857 -m TEXT, --message=TEXT
2858 specify log message TEXT
2859 update (up)
2863 Update a working copy
2864 examples:
2866 1. osc up
2868 If the current working directory is a package, update
2869 it.
2870 If the directory is a project directory, update all con‐
2871 tained
2872 packages, AND check out newly added packages.
2873 To update only checked out packages, without checking
2875 out new
2876 ones, you might want to use "osc up *" from within the
2877 project
2878 dir.
2879 2. osc up PAC
2881 Update the packages specified by the path argument(s)
2882 When --expand-link is used with source link packages, the ex‐
2884 panded sources will be checked out. Without this option, the
2885 _link file and patches will be checked out. The option --unex‐
2886 pand-link can be used to switch back to the "raw" source with a
2887 _link file plus patch(es).
2888 Usage:
2890 osc update [ARGS...]
2891 Options:
2893 -h, --help show this help message and exit
2894 -l limit_size, --limit-size=limit_size
2895 Skip all files with a given size
2896 -S, --server-side-source-service-files
2897 Use server side generated sources instead of lo‐
2898 cal
2899 generation.
2900 -s, --source-service-files
2901 Run local source services after update.
2902 -e, --expand-link
2903 if a package is a link, update to the expanded
2904 sources
2905 -u, --unexpand-link
2906 if a package is an expanded link, update to the
2907 raw
2908 _link file
2909 --linkrev=REV
2910 revision of the link target that is used during
2911 link
2912 expansion
2913 -r REV, --revision=REV
2914 update to specified revision (this option will
2915 be
2916 ignored if you are going to update the complete
2917 project or more than one package)
2918 updatepacmetafromspec (metafromspec, updatepkgmetafromspec)
2922 Update package meta information from a specfile
2923 ARG, if specified, is a package working copy.
2925 Usage:
2927 osc updatepacmetafromspec [ARGS...]
2928 Options:
2930 -h, --help show this help message and exit
2931 --specfile=FILE
2932 Path to specfile. (if you pass more than working
2933 copy
2934 this option is ignored)
2935 vc Edit the changes file
2939 osc vc [-m MESSAGE|-e] [filename[.changes]|path [file_with_com‐
2941 ment]] If no <filename> is given, exactly one *.changes or
2942 *.spec file has to be in the cwd or in path.
2943 The email address used in .changes file is read from BuildSer‐
2945 vice instance, or should be defined in oscrc [https://api.open‐
2946 suse.org/] user = login pass = password email = user@de‐
2947 fined.email
2948 or can be specified via mailaddr environment variable.
2950 Usage:
2952 osc vc [ARGS...]
2953 Options:
2955 -h, --help show this help message and exit
2956 -e, --just-edit
2957 just open changes (cannot be used with -m)
2958 -F FILE, --file=FILE
2959 read changes message from FILE (do not open an
2960 editor)
2961 -m MESSAGE, --message=MESSAGE
2962 add MESSAGE to changes (do not open an editor)
2963 whatdependson
2967 Show the packages that require the specified package during the
2968 build.
2969 The command whatdependson can be used to find out what will be
2971 triggered when a certain package changes.
2972 This is no guarantee, since the new build might have changed de‐
2974 pendencies.
2975 The arguments REPOSITORY and ARCH can be taken from the first
2977 two columns of the 'osc repos' output.
2978 usage in package or project directory:
2980 osc whatdependson REPOSITORY ARCH
2981 usage:
2983 osc whatdependson PROJECT [PACKAGE] REPOSITORY ARCH
2984 whois (user, who)
2988 Show fullname and email of a buildservice user
2989 Usage:
2991 osc whois [USERNAMES...]
2992 wipebinaries (unpublish)
2996 Delete all binary packages of a certain project/package
2997 With the optional argument <package> you can specify a certain
2999 package otherwise all binary packages in the project will be
3000 deleted.
3001 usage:
3003 osc wipebinaries OPTS # works in
3004 checked out project dir
3005 osc wipebinaries OPTS PROJECT [PACKAGE]
3006 osc unpublish OPTS # works in checked
3007 out project dir
3008 osc unpublish OPTS PROJECT [PACKAGE] Options:
3009 -h, --help show this help message and exit
3010 --all Delete all binaries regardless of the package
3011 status
3012 (previously default)
3013 --unresolvable
3014 Delete all binaries of packages which have de‐
3015 pendency
3016 errors
3017 --broken Delete all binaries of packages for which the
3018 package
3019 source is bad
3020 --build-failed
3021 Delete all binaries of packages for which the
3022 build
3023 failed
3024 --build-disabled
3025 Delete all binaries of packages for which the
3026 build is
3027 disabled
3028 -r REPO, --repo=REPO
3029 Delete all binary packages for a specific repos‐
3030 itory
3031 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
3032 AGE
3033 Delete all binary packages for specified multi‐
3034 build
3035 package
3036 -a ARCH, --arch=ARCH
3037 Delete all binary packages for a specific archi‐
3038 tecture
3039 workerinfo
3043 gets the information to a worker from the server
3044 Examples:
3046 osc workerinfo x86_64:goat:1
3047 Usage:
3049 osc workerinfo <hostarch>:<workerid>
3050 GLOBAL OPTIONS
3055 Options:
3056 --version show program's version number and exit
3057 -h, --help show this help message and exit
3058 --debugger jump into the debugger before executing any‐
3059 thing
3060 --post-mortem jump into the debugger in case of errors
3061 -t, --traceback print call trace in case of errors
3062 -H, --http-debug debug HTTP traffic (filters some headers)
3063 --http-full-debug debug HTTP traffic (filters no headers)
3064 -d, --debug print info useful for debugging
3065 -A URL/alias, --apiurl=URL/alias
3066 specify URL to access API server at or an alias
3067 -c FILE, --config=FILE
3068 specify alternate configuration file
3069 --no-keyring disable usage of desktop keyring system
3070 --no-gnome-keyring disable usage of GNOME Keyring
3071 -v, --verbose increase verbosity
3072 -q, --quiet be quiet, not verbose
3073
3077 Type 'osc help <subcommand>' for more detailed help on a specific sub‐
3078 command.
3079 For additional information, see
3081 * http://en.opensuse.org/openSUSE:Build_Service_Tutorial
3082 * http://en.opensuse.org/openSUSE:OSC
3083 You can modify osc commands, or roll your own, via the plugin API:
3085 * http://en.opensuse.org/openSUSE:OSC_plugins
3086
3088 osc was written by several authors. This man page is automatically gen‐
3089 erated.
3090osc 0.174 Jul 2021 OSC(1)