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 build Build a package on your local machine
224 You need to call the command inside a package directory, which
226 should be a buildsystem checkout. (Local modifications are
227 fine.)
228 The arguments REPOSITORY and ARCH can be taken from the first
230 two columns of the 'osc repos' output. BUILD_DESCR is either a
231 RPM spec file, or a Debian dsc file.
232 The command honors packagecachedir, build-root and build-uid
234 settings in oscrc, if present. You may want to set su-wrapper =
235 'sudo' in oscrc, and configure sudo with option NOPASSWD for
236 /usr/bin/build.
237 If neither --clean nor --noinit is given, build will reuse an
239 existing build-root again, removing unneeded packages and add
240 missing ones. This is usually the fastest option.
241 If the package doesn't exist on the server please use the
243 --local-package option. If the project of the package doesn't
244 exist on the server please use the --alternative-project <alter‐
245 native-project> option: Example:
246 osc build [OPTS] --alternative-project openSUSE:10.3 stan‐
247 dard i586 BUILD_DESCR
248 usage:
250 osc build [OPTS] REPOSITORY ARCH BUILD_DESCR
251 osc build [OPTS] REPOSITORY ARCH
252 osc build [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR is
253 detected automatically)
254 osc build [OPTS] ARCH (REPOSITORY = build_repository (config
255 option), BUILD_DESCR is detected automatically)
256 osc build [OPTS] BUILD_DESCR (REPOSITORY = build_repository
257 (config option), ARCH = hostarch)
258 osc build [OPTS] (REPOSITORY = build_repository (config
259 option), ARCH = hostarch, BUILD_DESCR is detected automatically)
260 # Note: # Configuration can be overridden by envvars, e.g. #
262 OSC_SU_WRAPPER overrides the setting of su-wrapper. #
263 OSC_BUILD_ROOT overrides the setting of build-root. # OSC_PACK‐
264 AGECACHEDIR overrides the setting of packagecachedir.
265 Options:
267 -h, --help show this help message and exit
268 --nopreinstallimage, --no-preinstallimage
269 Do not use preinstall images for creating the
270 build
271 root.
272 --trust-all-projects
273 trust packages from all projects
274 --host=HOST
275 perform the build on a remote server -
276 user@server:~/remote/directory
277 --oldpackages=DIR
278 take previous build from DIR (special values:
279 _self,
280 _link)
281 --download-api-only
282 only fetch packages from the api
283 --disable-cpio-bulk-download
284 disable downloading packages as cpio archive
285 from api
286 --release=N
287 set release number of the package to N
288 -b, --baselibs
289 Create -32bit/-64bit/-x86 rpms for other archi‐
290 tectures
291 --disable-debuginfo
292 disable build of debuginfo packages
293 -d, --debuginfo
294 also build debuginfo sub-packages
295 --alternative-project=PROJECT
296 specify the build target project
297 --target=TARGET
298 define target platform
299 --vm-telnet=TELNET
300 Launch a telnet server inside of VM build
301 --vm-type=TYPE
302 use VM type TYPE (e.g. kvm)
303 --vm-memory=MEMORY
304 use given MB for VM
305 --linksources
306 use hard links instead of a deep copied source
307 --local-package
308 build a package which does not exist on the
309 server
310 --build-uid=uid:gid|"caller"
311 specify the numeric uid:gid pair to assign to
312 the
313 unprivileged "abuild" user or use "caller" to
314 use the
315 current user uid:gid
316 --userootforbuild
317 Run build as root. The default is to build as
318 unprivileged user. Note that a line "# noroot‐
319 forbuild"
320 in the spec file will invalidate this option.
321 --build-opt=OPT
322 pass option OPT to the build command
323 --define='X Y'
324 define macro X with value Y
325 --without=X
326 disable feature X for build
327 --with=X enable feature X for build
328 --ccache use ccache to speed up rebuilds
329 --icecream=N
330 use N parallel build jobs with icecream
331 -t N, --threads=N
332 Compile with N threads
333 -j N, --jobs=N
334 Compile with N jobs
335 --root=ROOT
336 Build in specified directory
337 -x PAC, --extra-pkgs=PAC
338 Add this package when installing the build-root
339 -M MPAC, --multibuild-package=MPAC
340 Build the specified multibuild package
341 -k DIR, --keep-pkgs=DIR
342 Save built packages into this directory
343 -p DIR, --prefer-pkgs=DIR
344 Prefer packages from this directory when
345 installing
346 the build-root
347 --noservice, --no-service
348 Skip run of local source services as specified
349 in
350 _service file.
351 --no-verify, --noverify
352 Skip signature verification (via pgp keys) of
353 packages
354 used for build. (Global config in oscrc: no_ver‐
355 ify)
356 --nochecks, --no-checks
357 Do not run build checks on the resulting pack‐
358 ages.
359 --noinit, --no-init
360 Skip initialization of build root and start with
361 build
362 immediately.
363 --overlay=OVERLAY
364 Copy overlay filesystem to buildroot after
365 installing
366 all RPMs .
367 --rsync-dest=RSYNCDESTPATH
368 Copy folder to buildroot after installing all
369 RPMs.
370 Use together with --rsync-src. This is the path
371 on the
372 TARGET filesystem e.g.
373 /usr/src/packages/BUILD/linux-2.6 .
374 --rsync-src=RSYNCSRCPATH
375 Copy folder to buildroot after installing all
376 RPMs.
377 Use together with --rsync-dest. This is the path
378 on
379 the HOST filesystem e.g. /tmp/linux-kernel-tree.
380 It
381 defines RSYNCDONE 1 .
382 --no-changelog
383 don't update the package changelog from a
384 changes file
385 -l, --preload
386 Preload all files into the cache for offline
387 operation
388 -o, --offline
389 Start with cached prjconf and packages without
390 contacting the api server
391 --clean Delete old build root before initializing it
392 buildconfig
396 Shows the build config
397 Shows the build configuration which is used in building a pack‐
399 age. This command is mostly used internally by the 'build' com‐
400 mand.
401 The returned data is the project-wide build configuration in a
403 format which is directly readable by the build script. It con‐
404 tains RPM macros and BuildRequires expansions, for example.
405 The argument REPOSITORY an be taken from the first column of the
407 'osc repos' output.
408 usage:
410 osc buildconfig REPOSITORY (in pkg or
411 prj dir)
412 osc buildconfig PROJECT REPOSITORY
413 buildhistory (buildhist)
416 Shows the build history of a package
417 The arguments REPOSITORY and ARCH can be taken from the first
419 two columns of the 'osc repos' output.
420 usage:
422 osc buildhist REPOSITORY ARCHITECTURE
423 osc buildhist PROJECT PACKAGE REPOSITORY ARCHITECTURE
424 Options:
425 -h, --help show this help message and exit
426 -M MPAC, --multibuild-package=MPAC
427 Show the buildhistory of the specified multi‐
428 build
429 package
430 -l limit, --limit=limit
431 for setting the number of results
432 --csv generate output in CSV (separated by |)
433 buildinfo
437 Shows the build info
438 Shows the build "info" which is used in building a package.
440 This command is mostly used internally by the 'build' subcom‐
441 mand. It needs to be called from within a package directory.
442 The BUILD_DESCR argument is optional. BUILD_DESCR is a local RPM
444 specfile or Debian "dsc" file. If specified, it is sent to the
445 server, and the buildinfo will be based on it. If the argument
446 is not supplied, the buildinfo is derived from the specfile
447 which is currently on the source repository server.
448 The returned data is XML and contains a list of the packages
450 used in building, their source, and the expanded BuildRequires.
451 The arguments REPOSITORY and ARCH are optional. They can be
453 taken from the first two columns of the 'osc repos' output. If
454 not specified, REPOSITORY defaults to the 'build_repository'
455 config entry in your 'oscrc' and ARCH defaults to your host
456 architecture.
457 usage:
459 in a package working copy:
460 osc buildinfo [OPTS] REPOSITORY ARCH BUILD_DESCR
461 osc buildinfo [OPTS] REPOSITORY (ARCH = hostarch,
462 BUILD_DESCR is detected automatically)
463 osc buildinfo [OPTS] ARCH (REPOSITORY = build_repository
464 (config option), BUILD_DESCR is detected automatically)
465 osc buildinfo [OPTS] BUILD_DESCR (REPOSITORY =
466 build_repository (config option), ARCH = hostarch)
467 osc buildinfo [OPTS] (REPOSITORY = build_repository
468 (config option), ARCH = hostarch, BUILD_DESCR is detected auto‐
469 matically)
470 Note: if BUILD_DESCR does not exist locally the remote
471 BUILD_DESCR is used
472 osc buildinfo [OPTS] PROJECT PACKAGE REPOSITORY ARCH
474 [BUILD_DESCR]
475 Options:
477 -h, --help show this help message and exit
478 -p DIR, --prefer-pkgs=DIR
479 Prefer packages from this directory when
480 installing
481 the build-root
482 -x PAC, --extra-pkgs=PAC
483 Add this package when computing the buildinfo
484 -M MPAC, --multibuild-package=MPAC
485 Show the buildinfo of the specified multibuild
486 package
487 --alternative-project=PROJECT
488 specify the build target project
489 -d, --debug
490 verbose output of build dependencies
491 buildlog (bl, blt, buildlogtail)
495 Shows the build log of a package
496 Shows the log file of the build of a package. Can be used to
498 follow the log while it is being written. Needs to be called
499 from within a package directory.
500 When called as buildlogtail (or blt) it just shows the end of
502 the logfile. This is useful to see just a build failure rea‐
503 sons.
504 The arguments REPOSITORY and ARCH are the first two columns in
506 the 'osc results' output. If the buildlog url is used buildlog
507 command has the same behavior as remotebuildlog.
508 Usage:
510 osc buildlog [ARGS...]
511 [REPOSITORY ARCH | BUILDLOGURL] Options:
513 -h, --help show this help message and exit
514 -s, --strip-time
515 strip leading build time from the log
516 -o OFFSET, --offset=OFFSET
517 get log start or end from the offset
518 -M MPAC, --multibuild-package=MPAC
519 get log of the specified multibuild package
520 -l, --last Show the last finished log file
521 cat (blame, less)
525 Output the content of a file to standard output
526 Examples:
528 osc cat file
529 osc cat project package file
530 osc cat project/package/file
531 osc cat http://api.opensuse.org/build/.../_log
532 osc cat http://api.opensuse.org/source/../_link
533 osc less file
535 osc less project package file
536 osc blame file
538 osc blame project package file
539 Usage:
541 osc cat [ARGS...]
542 Options:
544 -h, --help show this help message and exit
545 -M, --meta list meta data files
546 -D, --deleted
547 access file in a deleted package
548 -u, --unexpand
549 always work with unexpanded packages.
550 -e, --expand
551 (default) force expansion of linked packages.
552 -r rev, --revision=rev
553 print out the specified revision
554 changedevelrequest (changedevelreq, cr)
558 Create request to change the devel package definition.
559 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
561 for information on this topic.]
562 See the "request" command for showing and modifying existing
564 requests.
565 osc changedevelrequest PROJECT PACKAGE DEVEL_PROJECT
567 [DEVEL_PACKAGE]
568 checkconstraints
571 check the constraints and view compliant workers
572 Checks the constraints for compliant workers.
574 usage:
576 remote request:
577 osc checkconstraints [OPTS] PROJECT PACKAGE REPOSITORY
578 ARCH
579 in a package working copy:
581 osc checkconstraints [OPTS] REPOSITORY ARCH CONSTRAINTS‐
582 FILE
583 osc checkconstraints [OPTS] CONSTRAINTSFILE
584 osc checkconstraints [OPTS]
585 Options:
587 -h, --help show this help message and exit
588 --ignore-file
589 ignore _constraints file and only check project
590 constraints
591 checkout (co)
595 Check out content from the repository
596 Check out content from the repository server, creating a local
598 working copy.
599 When checking out a single package, the option --revision can be
601 used to specify a revision of the package to be checked out.
602 When a package is a source link, then it will be checked out in
604 expanded form. If --unexpand-link option is used, the checkout
605 will instead produce the raw _link file plus patches.
606 usage:
608 osc co PROJECT [PACKAGE] [FILE]
609 osc co PROJECT # entire project
610 osc co PROJECT PACKAGE # a package
611 osc co PROJECT PACKAGE FILE # single file -> to
612 current dir
613 while inside a project directory:
615 osc co PACKAGE # check out PACKAGE
616 from project
617 with the result of rpm -q --qf '%{DISTURL}0 PACKAGE
619 osc co obs://API/PROJECT/PLATFORM/REVISION-PACKAGE
620 Options:
622 -h, --help show this help message and exit
623 -l limit_size, --limit-size=limit_size
624 Skip all files with a given size
625 -S, --server-side-source-service-files
626 Use server side generated sources instead of
627 local
628 generation.
629 -s, --source-service-files
630 Run source services.
631 -o outdir, --output-dir=outdir
632 place package in the specified directory instead
633 of a
634 PROJECT/PACKAGE directory
635 -c, --current-dir
636 place PACKAGE folder in the current directory
637 instead
638 of a PROJECT/PACKAGE directory
639 -M, --meta checkout out meta data instead of sources
640 -u, --unexpand-link
641 if a package is a link, check out the _link file
642 instead of the expanded sources
643 -D, --deleted
644 checkout an already deleted package. No meta
645 information
646 -e, --expand-link
647 if a package is a link, check out the expanded
648 sources
649 (no-op, since this became the default)
650 -r rev, --revision=rev
651 checkout the specified revision. NOTE: if you
652 checkout
653 the complete project this option is ignored!
654 chroot opens a shell inside of the build root
658 chroot into the build root for the given repository, arch and
660 build description (NOTE: this command does not work if a VM is
661 used)
662 usage:
664 osc chroot [OPTS] REPOSITORY ARCH BUILD_DESCR
665 osc chroot [OPTS] REPOSITORY (ARCH = hostarch, BUILD_DESCR
666 is detected automatically)
667 osc chroot [OPTS] ARCH (REPOSITORY = build_repository (con‐
668 fig option), BUILD_DESCR is detected automatically)
669 osc chroot [OPTS] BUILD_DESCR (REPOSITORY = build_repository
670 (config option), ARCH = hostarch)
671 osc chroot [OPTS] (REPOSITORY = build_repository (config
672 option), ARCH = hostarch, BUILD_DESCR is detected automatically)
673 Options:
674 -h, --help show this help message and exit
675 -f, --force
676 Do not ask confirmation for wipe
677 --wipe Delete the build root instead of chrooting into
678 it
679 -o, --offline
680 Use cached data without contacting the api
681 server
682 --root=ROOT
683 Path to the buildroot
684 -r, --login-as-root
685 login as root instead of abuild
686 --noinit, --no-init
687 do not guess/verify specified repository
688 --alternative-project=PROJECT
689 specify the used build target project
690 --local-package
691 package doesn't exist on the server
692 clean removes all untracked files from the package working copy
696 Examples:
698 osc clean <path>
699 Note: if <path> is omitted it defaults to '.' (<path> has to
701 be a package working copy)
702 Warning: This command removes all files with status '?'.
704 Usage:
706 osc clean [ARGS...]
707 Options:
709 -h, --help show this help message and exit
710 -n, --dry-run
711 print the results without actually removing a
712 file
713 comment
717 List / create / delete comments
718 On create:
720 If -p is given a reply to the ID is created. Otherwise
721 a toplevel comment is created.
722 If -c is not given the default editor will be opened and
723 you can type your comment
724 usage:
726 osc comment list package PROJECT PACKAGE
727 osc comment list project PROJECT
728 osc comment list request REQUEST_ID
729 osc comment create [-p PARENT_ID] [-c COMMENT] package
731 PROJECT PACKAGE
732 osc comment create [-p PARENT_ID] [-c COMMENT] project
733 PROJECT
734 osc comment create [-p PARENT_ID] [-c COMMENT] request
735 REQUEST_ID
736 osc comment delete ID
738 commit (checkin, ci)
742 Upload content to the repository server
743 Upload content which is changed in your working copy, to the
745 repository server.
746 examples:
748 osc ci # current dir
749 osc ci <dir>
750 osc ci file1 file2 ...
751 Usage:
753 osc commit [ARGS...]
754 Options:
756 -h, --help show this help message and exit
757 --skip-local-service-run, --noservice
758 Skip service run of configured source services
759 for
760 local run
761 -v, --verbose
762 Run the source services with verbose information
763 --skip-validation
764 deprecated, don't use it
765 -f, --force
766 force commit, even if there were no changes
767 -F FILE, --file=FILE
768 read log message from FILE, '-' denotes standard
769 input.
770 -n, --no-message
771 do not specify a log message
772 -m TEXT, --message=TEXT
773 specify log message TEXT
774 config get/set a config option
778 Examples:
780 osc config section option (get current value)
781 osc config section option value (set to value)
782 osc config section option --delete (delete option/reset to
783 the default)
784 (section is either an apiurl or an alias or 'general')
785 osc config --dump (dump the complete configuration)
786 Usage:
788 osc config [ARGS...]
789 Options:
791 -h, --help show this help message and exit
792 --dump-full
793 dump the complete configuration (including
794 'pass' and
795 'passx' options)
796 --dump dump the complete configuration (without 'pass'
797 and
798 'passx' options)
799 --no-echo prompt for a value but do not echo entered char‐
800 acters
801 -p, --prompt
802 prompt for a value
803 -s, --stdin
804 indicates that the config value should be read
805 from
806 stdin
807 -d, --delete
808 delete option from config or reset option to the
809 default)
810 copypac
814 Copy a package
815 A way to copy package to somewhere else.
817 It can be done across buildservice instances, if the -t option
819 is used. In that case, a client-side copy and link expansion
820 are implied.
821 Using --client-side-copy always involves downloading all files,
823 and uploading them to the target.
824 The DESTPAC name is optional; the source packages' name will be
826 used if DESTPAC is omitted.
827 usage:
829 osc copypac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
830 -h, --help show this help message and exit
831 -e, --expand
832 if the source package is a link then copy the
833 expanded
834 version of the link
835 -m TEXT, --message=TEXT
836 specify message TEXT
837 -t URL, --to-apiurl=URL
838 URL of destination api server. Default is the
839 source
840 api server.
841 -r rev, --revision=rev
842 copy the specified revision.
843 -d, --keep-develproject
844 keep develproject tag in the package metadata
845 -K, --keep-link
846 If the target package is a link, the link is
847 kept, but
848 may be updated. If the source package is a link,
849 its
850 expanded version is considered.
851 -k, --keep-maintainers
852 keep original maintainers. Default is remove all
853 and
854 replace with the one calling the script.
855 -c, --client-side-copy
856 do a (slower) client-side copy
857 createincident
861 Create a maintenance incident
862 [See http://openbuildservice.org/help/manuals/obs-reference-
864 guide/cha.obs.maintenance_setup.html for information on this
865 topic.]
866 This command is asking to open an empty maintenance incident.
868 This can usually only be done by a responsible maintenance team.
869 Please see the "mbranch" command on how to full such a project
870 content and the "patchinfo" command how add the required mainte‐
871 nance update information.
872 usage:
874 osc createincident [ MAINTENANCEPROJECT ] Options:
875 -h, --help show this help message and exit
876 -m TEXT, --message=TEXT
877 specify message TEXT
878 --noaccess Create a hidden project
879 -a ATTRIBUTE, --attribute=ATTRIBUTE
880 Use this attribute to find default maintenance
881 project
882 (default is OBS:MaintenanceProject)
883 createrequest (creq)
887 create multiple requests with a single command
888 usage:
890 osc creq [OPTIONS] [
891 -a submit SOURCEPRJ SOURCEPKG DESTPRJ [DESTPKG]
892 -a delete PROJECT [PACKAGE]
893 -a change_devel PROJECT PACKAGE DEVEL_PROJECT
894 [DEVEL_PACKAGE]
895 -a add_me ROLE PROJECT [PACKAGE]
896 -a add_group GROUP ROLE PROJECT [PACKAGE]
897 -a add_role USER ROLE PROJECT [PACKAGE]
898 -a set_bugowner USER PROJECT [PACKAGE]
899 ]
900 Option -m works for all types of request, the rest work only
902 for submit. example:
903 osc creq -a submit -a delete home:someone:branches:open‐
904 SUSE:Tools -a change_devel openSUSE:Tools osc home:some‐
905 one:branches:openSUSE:Tools -m ok
906 This will submit all modified packages under current direc‐
908 tory, delete project home:someone:branches:openSUSE:Tools and
909 change the devel project to home:someone:branches:openSUSE:Tools
910 for package osc in project openSUSE:Tools. Options:
911 -h, --help show this help message and exit
912 --yes proceed without asking.
913 --no-update
914 never touch source package on accept (will break
915 source links)
916 --no-cleanup
917 never remove source package on accept, but
918 update its
919 content
920 --cleanup remove package if submission gets accepted
921 (default
922 for home:<id>:branch projects)
923 --nodevelproject
924 do not follow a defined devel project (primary
925 project
926 where a package is developed)
927 -s REQUEST_ID, --supersede=REQUEST_ID
928 Superseding another request by this one
929 -r REV, --revision=REV
930 for "create", specify a certain source revision
931 ID
932 (the md5 sum)
933 -m TEXT, --message=TEXT
934 specify message TEXT
935 -a, --action
936 specify action type of a request, can be :
937 submit/delete/change_devel/add_role/set_bugowner
938 delete (del, remove, rm)
942 Mark files or package directories to be deleted upon the next
943 'checkin'
944 usage:
946 cd .../PROJECT/PACKAGE
947 osc delete FILE [...]
948 cd .../PROJECT
949 osc delete PACKAGE [...]
950 This command works on check out copies. Use "rdelete" for work‐
952 ing on server side only. This is needed for removing the entire
953 project.
954 As a safety measure, projects must be empty (i.e., you need to
956 delete all packages first).
957 If you are sure that you want to remove a package and all its
959 files use '--force' switch. Sometimes this also works without
960 --force.
961 Options:
963 -h, --help show this help message and exit
964 -f, --force
965 forces removal of entire package and its files
966 deleterequest (deletereq, dr, dropreq, droprequest)
970 Request to delete (or 'drop') a package or project
971 usage:
973 osc deletereq [-m TEXT] # works in
974 checked out project/package
975 osc deletereq [-m TEXT] PROJECT PACKAGE
976 osc deletereq [-m TEXT] PROJECT [--all|--repository REPOSI‐
977 TORY] Options:
978 -h, --help show this help message and exit
979 --accept-in-hours=HOURS
980 specify time when request shall get accepted
981 automatically. Only works with write permissions
982 in
983 target.
984 --all deletes entire project with packages inside
985 -r REPOSITORY, --repository=REPOSITORY
986 specify repository
987 -m TEXT, --message=TEXT
988 specify message TEXT
989 dependson (whatdependson)
993 Show the build dependencies
994 The command dependson and whatdependson can be used to find out
996 what will be triggered when a certain package changes. This is
997 no guarantee, since the new build might have changed dependen‐
998 cies.
999 dependson shows the build dependencies inside of a project,
1001 valid for a given repository and architecture. NOTE: to see all
1002 binary packages, which can trigger a build you need to
1003 refer the buildinfo, since this command shows only the
1004 dependencies
1005 inside of a project.
1006 The arguments REPOSITORY and ARCH can be taken from the first
1008 two columns of the 'osc repos' output.
1009 usage in package or project directory:
1011 osc dependson REPOSITORY ARCH
1012 osc whatdependson REPOSITORY ARCH
1013 usage:
1015 osc dependson PROJECT [PACKAGE] REPOSITORY ARCH
1016 osc whatdependson PROJECT [PACKAGE] REPOSITORY ARCH
1017 detachbranch
1021 replace a link with its expanded sources
1022 If a package is a link it is replaced with its expanded sources.
1024 The link does not exist anymore.
1025 usage:
1027 osc detachbranch # can be used in package
1028 working copy
1029 osc detachbranch PROJECT PACKAGE Options:
1030 -h, --help show this help message and exit
1031 -m TEXT, --message=TEXT
1032 specify message TEXT
1033 develproject (bsdevelproject, dp)
1037 print the devel project / package of a package
1038 Examples:
1040 osc develproject PRJ PKG
1041 osc develproject Options:
1042 -h, --help show this help message and exit
1043 -r, --raw deprecated option
1044 diff (di, ldiff, linkdiff)
1048 Generates a diff
1049 Generates a diff, comparing local changes against the repository
1051 server.
1052 Usage:
1054 osc diff [ARGS...]
1055 ARG, if specified, is a filename to include in the diff.
1057 Default: all files.
1058 osc diff --link
1060 osc linkdiff
1061 Compare current checkout directory against the link
1062 base.
1063 osc diff --link PROJ PACK
1065 osc linkdiff PROJ PACK
1066 Compare a package against the link base (ignoring work‐
1067 ing copy changes).
1068 Options:
1070 -h, --help show this help message and exit
1071 -u, --unexpand
1072 Local changes only, ignore changes in linked
1073 package
1074 sources
1075 --missingok
1076 do not fail if the source or target
1077 project/package
1078 does not exist on the server
1079 -l, --link (osc linkdiff): compare against the base revi‐
1080 sion of
1081 the link
1082 -p, --plain
1083 output the diff in plain (not unified) diff for‐
1084 mat
1085 -M, --meta operate on meta files
1086 -r rev1[:rev2], --revision=rev1[:rev2]
1087 If rev1 is specified it will compare your work‐
1088 ing copy
1089 against the revision (rev1) on the server. If
1090 rev1 and
1091 rev2 are specified it will compare rev1 against
1092 rev2
1093 (NOTE: changes in your working copy are ignored
1094 in
1095 this case)
1096 -c rev, --change=rev
1097 the change made by revision rev (like -r
1098 rev-1:rev).If
1099 rev is negative this is like -r rev:rev-1.
1100 distributions (dists)
1104 Shows all available distributions
1105 This command shows the available distributions. For active dis‐
1107 tributions it shows the name, project and name of the repository
1108 and a suggested default repository name.
1109 usage:
1111 osc distributions
1112 enablechannels (enablechannel)
1116 Enables channels
1117 Enables existing channel packages in a project. Enabling means
1119 adding the needed repositories for building. The command can be
1120 used to enable a specific one or all channels of a project.
1121 Examples:
1123 osc enablechannels [PROJECT [CHANNEL_PACKAGE]]
1124 getbinaries
1127 Download binaries to a local directory
1128 This command downloads packages directly from the api server.
1130 Thus, it directly accesses the packages that are used for build‐
1131 ing others even when they are not "published" yet.
1132 usage:
1134 osc getbinaries REPOSITORY #
1135 works in checked out project/package (check out all archs in
1136 subdirs)
1137 osc getbinaries REPOSITORY ARCHITECTURE #
1138 works in checked out project/package
1139 osc getbinaries PROJECT REPOSITORY ARCHITECTURE
1140 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE
1141 osc getbinaries PROJECT PACKAGE REPOSITORY ARCHITECTURE FILE
1142 Options:
1143 -h, --help show this help message and exit
1144 --debug also fetch debug packages
1145 --sources also fetch source packages
1146 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1147 AGE
1148 get binaries from specified multibuild package
1149 -d DIR, --destdir=DIR
1150 destination directory
1151 -q, --quiet
1152 do not show downloading progress
1153 help (?, h)
1157 give detailed help on a specific sub-command
1158 usage:
1160 osc help [SUBCOMMAND]
1161 importsrcpkg
1164 Import a new package from a src.rpm
1165 A new package dir will be created inside the project dir (if no
1167 project is specified and the current working dir is a project
1168 dir the package will be created in this project). If the package
1169 does not exist on the server it will be created too otherwise
1170 the meta data of the existing package will be updated (<title />
1171 and <description />). The src.rpm will be extracted into the
1172 package dir. The files won't be committed unless you explicitly
1173 pass the --commit switch.
1174 SRPM is the path of the src.rpm in the local filesystem, or an
1176 URL.
1177 Usage:
1179 osc importsrcpkg SRPM
1180 Options:
1182 -h, --help show this help message and exit
1183 -c, --commit
1184 commit the new files
1185 --delete-old-files
1186 delete existing files from the server
1187 -d description, --description=description
1188 set the description of the package
1189 -t title, --title=title
1190 set a title
1191 -n name, --name=name
1192 specify a package name
1193 -p project, --project=project
1194 specify the path to a project
1195 info Print information about a working copy
1199 Print information about each ARG (default: '.') ARG is a work‐
1201 ing-copy path.
1202 Usage:
1204 osc info [ARGS...]
1205 init Initialize a directory as working copy
1209 Initialize an existing directory to be a working copy of an
1211 (already existing) buildservice project/package.
1212 (This is the same as checking out a package and then copying
1214 sources into the directory. It does NOT create a new package. To
1215 create a package, use 'osc meta pkg ... ...')
1216 You wouldn't normally use this command.
1218 To get a working copy of a package (e.g. for building it or
1220 working on it, you would normally use the checkout command. Use
1221 "osc help checkout" to get help for it.
1222 usage:
1224 osc init PRJ
1225 osc init PRJ PAC
1226 jobhistory (jobhist)
1229 Shows the job history of a project
1230 The arguments REPOSITORY and ARCH can be taken from the first
1232 two columns of the 'osc repos' output.
1233 usage:
1235 osc jobhist REPOSITORY ARCHITECTURE (in project dir)
1236 osc jobhist PROJECT [PACKAGE] REPOSITORY ARCHITECTURE
1237 Options:
1238 -h, --help show this help message and exit
1239 -M MPAC, --multibuild-package=MPAC
1240 get jobhistory for the specified multibuild
1241 package
1242 -l limit, --limit=limit
1243 for setting the number of results
1244 --csv generate output in CSV (separated by |)
1245 linkpac
1249 "Link" a package to another package
1250 A linked package is a clone of another package, but plus local
1252 modifications. It can be cross-project.
1253 The DESTPAC name is optional; the source packages' name will be
1255 used if DESTPAC is omitted.
1256 Afterwards, you will want to 'checkout DESTPRJ DESTPAC'.
1258 To add a patch, add the patch as file and add it to the _link
1260 file. You can also specify text which will be inserted at the
1261 top of the spec file.
1262 See the examples in the _link file.
1264 NOTE: In case you want to fix or update another package, you
1266 should use the 'branch'
1267 command. A branch has correct repositories (and a link)
1268 setup up by default and
1269 will be cleaned up automatically after it was submitted
1270 back.
1271 usage:
1273 osc linkpac SOURCEPRJ SOURCEPAC DESTPRJ [DESTPAC] Options:
1274 -h, --help show this help message and exit
1275 -N, --new-package
1276 create a link to a not yet existing package
1277 -d, --disable-publish
1278 disable publishing of the linked package
1279 -f, --force
1280 overwrite an existing link file if it is there.
1281 -r rev, --revision=rev
1282 link the specified revision.
1283 -c, --current
1284 link fixed against current revision.
1285 -C CICOUNT, --cicount=CICOUNT
1286 cicount attribute in the link, known values are
1287 add,
1288 copy, and local, default in buildservice is cur‐
1289 rently
1290 add.
1291 linktobranch
1295 Convert a package containing a classic link with patch to a
1296 branch
1297 This command tells the server to convert a _link with or without
1299 a project.diff to a branch. This is a full copy with a _link
1300 file pointing to the branched place.
1301 usage:
1303 osc linktobranch # can be used in checked
1304 out package
1305 osc linktobranch PROJECT PACKAGE
1306 list (LL, lL, ll, ls)
1309 List sources or binaries on the server
1310 Examples for listing sources:
1312 ls # list all projects (deprecated)
1313 ls / # list all projects
1314 ls . # take PROJECT/PACKAGE from cur‐
1315 rent dir.
1316 ls PROJECT # list packages in a project
1317 ls PROJECT PACKAGE # list source files of package of
1318 a project
1319 ls PROJECT PACKAGE <file> # list <file> if this file exists
1320 ls -v PROJECT PACKAGE # verbosely list source files of
1321 package
1322 ls -l PROJECT PACKAGE # verbosely list source files of
1323 package
1324 ll PROJECT PACKAGE # verbosely list source files of
1325 package
1326 LL PROJECT PACKAGE # verbosely list source files of
1327 expanded link
1328 With --verbose, the following fields will be shown for each
1330 item:
1331 MD5 hash of file
1332 Revision number of the last commit
1333 Size (in bytes)
1334 Date and time of the last commit
1335 Examples for listing binaries:
1337 ls -b PROJECT # list all binaries of a project
1338 ls -b PROJECT -a ARCH # list ARCH binaries of a project
1339 ls -b PROJECT -r REPO # list binaries in REPO
1340 ls -b PROJECT PACKAGE REPO ARCH
1341 Usage:
1343 list (LL, lL, ll, ls) [PROJECT [PACKAGE]]
1344 list (LL, lL, ll, ls) -b [PROJECT [PACKAGE [REPO [ARCH]]]]
1345 Options:
1346 -h, --help show this help message and exit
1347 -R REVISION, --revision=REVISION
1348 specify revision (only for sources)
1349 -M, --meta list meta data files
1350 -D, --deleted
1351 show only the former deleted projects or pack‐
1352 ages
1353 -l, --long print extra information
1354 -v, --verbose
1355 print extra information
1356 -u, --unexpand
1357 always work with unexpanded (source) packages
1358 -e, --expand
1359 expand linked package (only for sources)
1360 -b, --binaries
1361 list built binaries instead of sources
1362 -r REPO, --repo=REPO
1363 specify repository (only for binaries)
1364 -a ARCH, --arch=ARCH
1365 specify architecture (only for binaries)
1366 localbuildlog (lbl)
1370 Shows the build log of a local buildchroot
1371 usage:
1373 osc lbl [REPOSITORY [ARCH]]
1374 osc lbl # show log of newest last local build
1375 Options:
1377 -h, --help show this help message and exit
1378 -s, --strip-time
1379 strip leading build time from the log
1380 -o OFFSET, --offset=OFFSET
1381 get log starting from offset
1382 lock Locks a project or package.
1386 usage:
1388 osc lock PROJECT [PACKAGE]
1389 Options:
1391 -h, --help show this help message and exit
1392 -m TEXT, --message=TEXT
1393 specify log message TEXT
1394 log Shows the commit log of a package
1398 Usage:
1400 osc log (inside working copy)
1401 osc log remote_project [remote_package]
1402 Options:
1404 -h, --help show this help message and exit
1405 -M, --meta checkout out meta data instead of sources
1406 -D, --deleted
1407 work on deleted package
1408 --xml generate output in XML
1409 --csv generate output in CSV (separated by |)
1410 -r rev, --revision=rev
1411 show log of the specified revision
1412 maintainer (bugowner)
1416 Show maintainers according to server side configuration
1417 # Search for official maintained sources in OBS instance
1419 osc maintainer BINARY <options>
1420 osc maintainer -U <user> <options>
1421 osc maintainer -G <group> <options>
1422 # Lookup via containers
1424 osc maintainer <options>
1425 osc maintainer PRJ <options>
1426 osc maintainer PRJ PKG <options>
1427 The tool looks up the default responsible person for a certain
1429 project or package. When using with an OBS 2.4 (or later)
1430 server it is doing the lookup for a given binary according to
1431 the server side configuration of default owners.
1432 The tool is also looking into devel packages and supports to
1434 fallback to the project in case a package has no defined main‐
1435 tainer.
1436 Please use "osc meta pkg" in case you need to know the defini‐
1438 tion in a specific container.
1439 PRJ and PKG default to current working-copy path.
1441 Usage:
1443 osc maintainer [ARGS...]
1444 Options:
1446 -h, --help show this help message and exit
1447 -m MESSAGE, --message=MESSAGE
1448 Define message as commit entry or request
1449 description
1450 -r role, --role=role
1451 Specify user role
1452 -d user, --delete=user
1453 delete a maintainer/bugowner (can be specified
1454 via
1455 --role)
1456 -G GROUP, --group=GROUP
1457 All official maintained instances for the speci‐
1458 fied
1459 GROUP
1460 -U USER, --user=USER
1461 All official maintained instances for the speci‐
1462 fied
1463 USER
1464 -S user, --set-bugowner-request=user
1465 Set the bugowner to specified person via a
1466 request (or
1467 group via group: prefix)
1468 -s user, --set-bugowner=user
1469 Set the bugowner to specified person (or group
1470 via
1471 group: prefix)
1472 -A, --all list all found entries not just the first one
1473 -a user, --add=user
1474 add a new person for given role ("maintainer" by
1475 default)
1476 -D devel_project, --devel-project=devel_project
1477 define the project where this package is primar‐
1478 ily
1479 developed
1480 -v, --verbose
1481 show more information
1482 --nodevelproject
1483 do not follow a defined devel project (primary
1484 project
1485 where a package is developed)
1486 -e, --email
1487 show email addresses instead of user names
1488 -B, --bugowner
1489 Show only the bugowner if defined, or maintainer
1490 otherwise
1491 -b, --bugowner-only
1492 Show only the bugowner
1493 maintenancerequest (mr)
1497 Create a request for starting a maintenance incident.
1498 [See http://openbuildservice.org/help/manuals/obs-reference-
1500 guide/cha.obs.maintenance_setup.html for information on this
1501 topic.]
1502 This command is asking the maintenance team to start a mainte‐
1504 nance incident based on a created maintenance update. Please see
1505 the "mbranch" command on how to create such a project and the
1506 "patchinfo" command how add the required maintenance update
1507 information.
1508 usage:
1510 osc maintenancerequest [ SOURCEPROJECT [ SOURCEPACKAGES
1511 RELEASEPROJECT ] ]
1512 osc maintenancerequest .
1513 The 2nd line when issued within a package directory provides a
1515 short cut to submit a single package (the one in the current
1516 directory) from the project of this package to be submitted to
1517 the release project this package links to. This syntax is only
1518 valid when specified from a package subdirectory. Options:
1519 -h, --help show this help message and exit
1520 -s REQUEST_ID, --supersede=REQUEST_ID
1521 Superseding another request by this one
1522 --incident-project=INCIDENT_PROJECT
1523 specify incident project to merge in
1524 --incident=INCIDENT
1525 specify incident number to merge in
1526 --cleanup do remove source project on accept
1527 --no-cleanup
1528 do not remove source project on accept
1529 --release-project=RELEASEPROJECT
1530 Specify the release project
1531 -m TEXT, --message=TEXT
1532 specify message TEXT
1533 -a ATTRIBUTE, --attribute=ATTRIBUTE
1534 Use this attribute to find default maintenance
1535 project
1536 (default is OBS:MaintenanceProject)
1537 man generates a man page
1541 usage:
1543 osc man
1544 mbranch (maintained, sm)
1547 Search or branch multiple instances of a package
1548 This command is used for searching all relevant instances of
1550 packages and creating links of them in one project. This is
1551 esp. used for maintenance updates. It can also be used to branch
1552 all packages marked before with a given attribute.
1553 [See http://en.opensuse.org/openSUSE:Build_Service_Concept_Main‐
1555 tenance for information on this topic.]
1556 The branched package will live in
1558 home:USERNAME:branches:ATTRIBUTE:PACKAGE if nothing else
1559 specified.
1560 usage:
1562 osc sm [SOURCEPACKAGE] [-a ATTRIBUTE]
1563 osc mbranch [ SOURCEPACKAGE [ TARGETPROJECT ] ] Options:
1564 -h, --help show this help message and exit
1565 --nodevelproject
1566 do not follow a defined devel project (primary
1567 project
1568 where a package is developed)
1569 --noaccess Create a hidden project
1570 --dryrun Just simulate the action and report back the
1571 result.
1572 -u UPDATE_ATTRIBUTE,
1573 --update-project-attribute=UPDATE_ATTRIBUTE
1574 Use this attribute to find update projects
1575 (default is
1576 OBS:UpdateProject)
1577 -a ATTRIBUTE, --attribute=ATTRIBUTE
1578 Use this attribute to find affected packages
1579 (default
1580 is OBS:Maintained)
1581 -c, --checkout
1582 Checkout branched package afterwards ('osc bco'
1583 is a
1584 shorthand for this option)
1585 meta Show meta information, or edit it
1589 Show or edit build service metadata of type <prj|pkg|prj‐
1591 conf|user|pattern>.
1592 This command displays metadata on buildservice objects like
1594 projects, packages, or users. The type of metadata is specified
1595 by the word after "meta", like e.g. "meta prj".
1596 prj denotes metadata of a buildservice project. prjconf denotes
1598 the (build) configuration of a project. pkg denotes metadata of
1599 a buildservice package. user denotes the metadata of a user.
1600 group denotes the metadata of a group. pattern denotes instal‐
1601 lation patterns defined for a project.
1602 To list patterns, use 'osc meta pattern PRJ'. An additional
1604 argument will be the pattern file to view or edit.
1605 With the --edit switch, the metadata can be edited. Per default,
1607 osc opens the program specified by the environmental variable
1608 EDITOR with a temporary file. Alternatively, content to be saved
1609 can be supplied via the --file switch. If the argument is '-',
1610 input is taken from stdin: osc meta prjconf home:user | sed ...
1611 | osc meta prjconf home:user -F -
1612 For meta prj and prjconf updates optional commit messages can be
1614 applied with --message.
1615 When trying to edit a non-existing resource, it is created
1617 implicitly.
1618 Examples:
1621 osc meta prj PRJ
1622 osc meta pkg PRJ PKG
1623 osc meta pkg PRJ PKG -e
1624 Usage:
1626 osc meta <prj|prjconf> [-r|--revision REV] ARGS...
1627 osc meta <prj|pkg|prjconf|user|group|pattern> ARGS...
1628 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1629 TEXT] -e|--edit ARGS...
1630 osc meta <prj|pkg|prjconf|user|group|pattern> [-m|--message
1631 TEXT] -F|--file ARGS...
1632 osc meta pattern --delete PRJ PATTERN
1633 osc meta attribute PRJ [PKG [SUBPACKAGE]] [--attribute
1634 ATTRIBUTE] [--create [--set <value_list>]|--delete|--set
1635 <value_list>] Options:
1636 -h, --help show this help message and exit
1637 --delete delete a pattern or attribute
1638 -s ATTRIBUTE_VALUES, --set=ATTRIBUTE_VALUES
1639 set attribute values
1640 -R, --remove-linking-repositories
1641 Try to remove also all repositories building
1642 against
1643 remove ones.
1644 -c, --create
1645 create attribute without values
1646 -e, --edit edit metadata
1647 -m TEXT, --message=TEXT
1648 specify log message TEXT. For prj and prjconf
1649 meta
1650 only
1651 -r REV, --revision=REV
1652 checkout given revision instead of head revi‐
1653 sion. For
1654 prj and prjconf meta only
1655 -F FILE, --file=FILE
1656 read metadata from FILE, instead of opening an
1657 editor.
1658 '-' denotes standard input.
1659 -f, --force
1660 force the save operation, allows one to ignores
1661 some
1662 errors like depending repositories. For prj meta
1663 only.
1664 --blame show author and time of each line
1665 --attribute-project
1666 include project values, if missing in packages
1667 --attribute-defaults
1668 include defined attribute defaults
1669 -a ATTRIBUTE, --attribute=ATTRIBUTE
1670 affect only a given attribute
1671 mkpac Create a new package under version control
1675 usage:
1677 osc mkpac new_package
1678 mv Move SOURCE file to DEST and keep it under version control
1681 Usage:
1683 osc mv SOURCE DEST
1684 Options:
1686 -h, --help show this help message and exit
1687 -f, --force
1688 forces removal of entire package and its files
1689 my show waiting work, packages, projects or requests involving
1693 yourself
1694 Examples:
1696 # list all open tasks for me
1697 osc my [work]
1698 # list packages where I am bugowner
1699 osc my pkg -b
1700 # list projects where I am maintainer
1701 osc my prj -m
1702 # list request for all my projects and packages
1703 osc my rq
1704 # list requests, excluding project 'foo' and 'bar'
1705 osc my rq --exclude-project foo,bar
1706 # list requests I made
1707 osc my sr
1708 Usage:
1710 osc my [ARGS...]
1711 where TYPE is one of requests, submitrequests,
1713 projects or packages (rq, sr, prj or pkg)
1714 Options:
1716 -h, --help
1717 show this help message and exit
1718 --maintained
1719 limit search results to packages with maintained
1720 attribute set.
1721 -v, --verbose
1722 verbose listing
1723 --exclude-project=EXCLUDE_PROJECT
1724 exclude requests for specified project
1725 -U USER, --user=USER
1726 search for USER instead of yourself
1727 -a, --all
1728 all involvements
1729 -m, --maintainer
1730 restrict listing to items where the user is
1731 maintainer
1732 -b, --bugowner
1733 restrict listing to items where the user is
1734 bugowner
1735 patchinfo
1739 Generate and edit a patchinfo file.
1740 A patchinfo file describes the packages for an update and the
1742 kind of problem it solves.
1743 This command either creates a new _patchinfo or updates an
1745 existing one.
1746 Examples:
1748 osc patchinfo
1749 osc patchinfo [PROJECT [PATCH_NAME]] Options:
1750 -h, --help show this help message and exit
1751 -f, --force
1752 force generation of new patchinfo file, do not
1753 update
1754 existing one.
1755 pdiff Quick alias to diff the content of a package with its parent.
1759 Usage:
1761 osc pdiff [--plain|-p] [--nomissing-ok|-n]
1762 osc pdiff [--plain|-p] [--nomissing-ok|-n] PKG
1763 osc pdiff [--plain|-p] [--nomissing-ok|-n] PRJ PKG
1764 Options:
1766 -h, --help show this help message and exit
1767 -n, --nomissingok
1768 fail if the parent package does not exist on the
1769 server
1770 -p, --plain
1771 output the diff in plain (not unified) diff for‐
1772 mat
1773 prdiff (projdiff, projectdiff)
1777 Server-side diff of two projects
1778 Compares two projects and either summarizes or outputs the dif‐
1780 ferences in full. In the second form, a project is compared
1781 with one of its branches inside a home:$USER project (the branch
1782 is treated as NEWPRJ). The home branch is optional if the cur‐
1783 rent working directory is a checked out copy of it.
1784 Usage:
1786 osc prdiff [OPTIONS] OLDPRJ NEWPRJ
1787 osc prdiff [OPTIONS] [home:$USER:branch:$PRJ]
1788 Options:
1790 -h, --help show this help message and exit
1791 -d, --diffstat
1792 show diffstat of differences
1793 -u, --unified
1794 show full unified diffs of differences
1795 -o, --show-not-in-new
1796 show packages only in the old project
1797 -n, --show-not-in-old
1798 show packages only in the new project
1799 -i REGEXP, --include=REGEXP
1800 only consider packages matching REGEXP
1801 -e REGEXP, --exclude=REGEXP
1802 skip packages matching REGEXP
1803 -r, --requests
1804 show open requests for any packages with differ‐
1805 ences
1806 prjresults (pr)
1810 Shows project-wide build results
1811 Usage:
1813 osc prjresults (inside working copy)
1814 osc prjresults PROJECT
1815 Options:
1817 -h, --help show this help message and exit
1818 --show-excluded
1819 show packages that are excluded in all repos,
1820 also
1821 hide repos that have only excluded packages
1822 -V, --vertical
1823 list packages vertically instead horizontally
1824 -r REPO, --repo=REPO
1825 show results only for specified repo(s)
1826 -a ARCH, --arch=ARCH
1827 show results only for specified architecture(s)
1828 -n EXPR, --name-filter=EXPR
1829 show only packages whose names match EXPR
1830 -s STATUS, --status-filter=STATUS
1831 show only packages with buildstatus STATUS (see
1832 legend)
1833 --xml generate output in XML
1834 -c, --csv csv output
1835 -w, --watch
1836 watch the results until all finished building,
1837 only
1838 supported with --xml
1839 -q, --hide-legend
1840 hide the legend
1841 pull merge the changes of the link target into your working copy.
1845 rdelete
1849 Delete a project or packages on the server.
1850 As a safety measure, project must be empty (i.e., you need to
1852 delete all packages first). Also, packages must have no requests
1853 pending (i.e., you need to accept/revoke such requests first).
1854 If you are sure that you want to remove this project and all its
1855 packages use '--recursive' switch. It may still not work
1856 because other depends on it. If you want to ignore this as well
1857 use '--force' switch.
1858 usage:
1860 osc rdelete [-r] [-f] PROJECT [PACKAGE]
1861 Options:
1863 -h, --help show this help message and exit
1864 -m TEXT, --message=TEXT
1865 specify log message TEXT
1866 -f, --force
1867 deletes a project where other depends on
1868 -r, --recursive
1869 deletes a project with packages inside
1870 rdiff Server-side "pretty" diff of two packages
1874 Compares two packages (three or four arguments) or shows the
1876 changes of a specified revision of a package (two arguments)
1877 If no revision is specified the latest revision is used.
1879 Note that this command doesn't return a normal diff (which could
1881 be applied as patch), but a "pretty" diff, which also compares
1882 the content of tarballs.
1883 usage:
1886 osc rdiff OLDPRJ OLDPAC NEWPRJ [NEWPAC]
1887 osc rdiff PROJECT PACKAGE Options:
1888 -h, --help show this help message and exit
1889 -u, --unexpand
1890 diff unexpanded version if sources are linked
1891 --missingok
1892 do not fail if the source or target
1893 project/package
1894 does not exist on the server
1895 -c rev, --change=rev
1896 the change made by revision rev (like -r
1897 rev-1:rev).
1898 If rev is negative this is like -r rev:rev-1.
1899 -p, --plain
1900 output the diff in plain (not unified) diff for‐
1901 mat
1902 -r N[:M], --revision=N[:M]
1903 revision id, where N = old revision and M = new
1904 revision
1905 -M, --meta diff meta data
1906 --issues-only
1907 show only issues in diff
1908 --oldpkg=OLDPKG
1909 package to compare against (deprecated, use 3
1910 argument
1911 form)
1912 --oldprj=OLDPRJ
1913 project to compare against (deprecated, use 3
1914 argument
1915 form)
1916 rebuild (rebuildpac)
1920 Trigger package rebuilds
1921 Note that it is normally NOT needed to kick off rebuilds like
1923 this, because they principally happen in a fully automatic way,
1924 triggered by source check-ins. In particular, the order in which
1925 packages are built is handled by the build service.
1926 The arguments REPOSITORY and ARCH can be taken from the first
1928 two columns of the 'osc repos' output.
1929 usage:
1931 osc rebuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]] Options:
1932 -h, --help show this help message and exit
1933 --all Rebuild all packages of entire project
1934 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
1935 AGE
1936 rebuild specified multibuild package
1937 -f, --failed
1938 rebuild all failed packages
1939 -r REPO, --repo=REPO
1940 trigger rebuilds for a specific repository
1941 -a ARCH, --arch=ARCH
1942 trigger rebuilds for a specific architecture
1943 release
1947 Release sources and binaries
1948 This command is used to transfer sources and binaries without
1950 rebuilding them. It requires defined release targets set to
1951 trigger="manual". Please refer the release management chapter in
1952 the OBS book for details.
1953 usage:
1955 osc release [ SOURCEPROJECT [ SOURCEPACKAGE ] ]
1956 Options:
1958 -h, --help show this help message and exit
1959 --no-delay Don't put the release job in a queue to be run
1960 later,
1961 but immediately run it. Thus the next call to
1962 osc
1963 prjresult will reflect it. Otherwise there is no
1964 way
1965 to know if it is finished or didn't start yet.
1966 --set-release=RELEASETAG
1967 rename binaries during release using this
1968 release tag
1969 --target-repository=TARGETREPOSITORY
1970 Release only to specified repository
1971 --target-project=TARGETPROJECT
1972 Release only to specified project
1973 -r REPO, --repo=REPO
1974 Release only binaries from the specified reposi‐
1975 tory
1976 releaserequest
1980 Create a request for releasing a maintenance update.
1981 [See http://openbuildservice.org/help/manuals/obs-reference-
1983 guide/cha.obs.maintenance_setup.html
1984 for information on this topic.]
1985 This command is used by the maintenance team to start the
1987 release process of a maintenance update. This includes usually
1988 testing based on the defined reviewers of the update project.
1989 usage:
1991 osc releaserequest [ SOURCEPROJECT ]
1992 Options:
1994 -h, --help show this help message and exit
1995 -m TEXT, --message=TEXT
1996 specify message TEXT
1997 remotebuildlog (rbl, rblt, rbuildlog, rbuildlogtail, remotebuildlog‐
2001 tail)
2002 Shows the build log of a package
2003 Shows the log file of the build of a package. Can be used to
2005 follow the log while it is being written.
2006 remotebuildlogtail shows just the tail of the log file.
2008 usage:
2010 osc remotebuildlog project package repository arch
2011 or
2012 osc remotebuildlog project/package/repository/arch
2013 or
2014 osc remotebuildlog buildlogurl Options:
2015 -h, --help show this help message and exit
2016 -s, --strip-time
2017 strip leading build time from the log
2018 -o OFFSET, --offset=OFFSET
2019 get log starting or ending from the offset
2020 -M MPAC, --multibuild-package=MPAC
2021 show log file for specified multibuild package
2022 -l, --last Show the last finished log file
2023 repairlink
2027 Repair a broken source link
2028 This command checks out a package with merged source changes. It
2030 uses a 3-way merge to resolve file conflicts. After review‐
2031 ing/repairing the merge, use 'osc resolved ...' and 'osc ci' to
2032 re-create a working source link.
2033 usage: * For merging conflicting changes of a checkout package:
2035 osc repairlink
2036 * Check out a package and merge changes:
2038 osc repairlink PROJECT PACKAGE
2039 * Pull conflicting changes from one project into another one:
2041 osc repairlink PROJECT PACKAGE INTO_PROJECT [INTO_PACKAGE]
2042 Options:
2044 -h, --help show this help message and exit
2045 -d DIR, --destdir=DIR
2046 destination directory
2047 repairwc
2051 try to repair an inconsistent working copy
2052 Examples:
2054 osc repairwc <path>
2055 Note: if <path> is omitted it defaults to '.' (<path> can be
2057 a project or package working copy)
2058 Warning: This command might delete some files in the storedir
2060 (.osc). Please check the state of the wc afterwards (via 'osc
2061 status').
2062 Usage:
2064 osc repairwc [ARGS...]
2065 Options:
2067 -h, --help show this help message and exit
2068 --force-apiurl
2069 ask once for an apiurl and force this apiurl for
2070 all
2071 inconsistent projects/packages
2072 repositories (platforms, repos)
2076 shows repositories configured for a project.
2077 It skips repositories by default which are dis‐
2078 abled for a given package.
2079 usage:
2081 osc repos
2082 osc repos [PROJECT] [PACKAGE]
2083 repourls
2087 Shows URLs of .repo files
2088 Shows URLs on which to access the project .repos files (yum-
2090 style metadata) on download.opensuse.org.
2091 usage:
2093 osc repourls [PROJECT]
2094 request (review, rq)
2098 Show or modify requests and reviews
2099 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2101 for information on this topic.]
2102 The 'request' command has the following sub commands:
2104 "list" lists open requests attached to a project or package or
2106 person. Uses the project/package of the current directory if
2107 none of -M, -U USER, project/package are given.
2108 "log" will show the history of the given ID
2110 "show" will show the request itself, and generate a diff for
2112 review, if used with the --diff option. The keyword show can be
2113 omitted if the ID is numeric.
2114 "decline" will change the request state to "declined"
2116 "reopen" will set the request back to new or review.
2118 "setincident" will direct "maintenance" requests into specific
2120 incidents
2121 "supersede" will supersede one request with another existing
2123 one.
2124 "revoke" will set the request state to "revoked"
2126 "accept" will change the request state to "accepted" and will
2128 trigger the actual submit process. That would normally be a
2129 server-side copy of the source package to the target package.
2130 "approve" marks a requests in "review" state as approved. This
2132 request will get accepted automatically when the last review got
2133 accepted.
2134 "checkout" will checkout the request's source package ("submit"
2136 requests only).
2137 "prioritize" change the priority of a request to either "criti‐
2139 cal", "important", "moderate" or "low"
2140 The 'review' command has the following sub commands:
2143 "list" lists open requests that need to be reviewed by the spec‐
2145 ified user or group
2146 "add" adds a person or group as reviewer to a request
2148 "accept" mark the review positive
2150 "decline" mark the review negative. A negative review will
2152 decline the request.
2153 usage:
2155 osc request list [-M] [-U USER] [-s state] [-D DAYS] [-t
2156 type] [-B] [PRJ [PKG]]
2157 osc request log ID
2158 osc request [show] [-d] [-b] ID
2159 osc request accept [-m TEXT] ID
2161 osc request approve [-m TEXT] ID
2162 osc request cancelapprove [-m TEXT] ID
2163 osc request decline [-m TEXT] ID
2164 osc request revoke [-m TEXT] ID
2165 osc request reopen [-m TEXT] ID
2166 osc request setincident [-m TEXT] ID INCIDENT
2167 osc request supersede [-m TEXT] ID SUPERSEDING_ID
2168 osc request approvenew [-m TEXT] PROJECT
2169 osc request prioritize [-m TEXT] ID PRIORITY
2170 osc request checkout/co ID
2172 osc request clone [-m TEXT] ID
2173 osc review show [-d] [-b] ID
2175 osc review list [-U USER] [-G GROUP] [-P PROJECT [-p PACK‐
2176 AGE]] [-s state]
2177 osc review add [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2178 [-p PACKAGE]] ID
2179 osc review accept [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2180 [-p PACKAGE]] ID
2181 osc review decline [-m TEXT] [-U USER] [-G GROUP] [-P
2182 PROJECT [-p PACKAGE]] ID
2183 osc review reopen [-m TEXT] [-U USER] [-G GROUP] [-P PROJECT
2184 [-p PACKAGE]] ID
2185 osc review supersede [-m TEXT] [-U USER] [-G GROUP] [-P
2186 PROJECT [-p PACKAGE]] ID SUPERSEDING_ID
2187 Options:
2189 -h, --help show this help message and exit
2190 --source-buildstatus
2191 print the buildstatus of the source package
2192 (only
2193 works with "show" and the interactive review)
2194 --target-package-filter=TARGET_PACKAGE_FILTER
2195 only list requests for the packages matching the
2196 package filter. A (python) regular expression is
2197 expected.
2198 --involved-projects
2199 show all requests for project/packages where
2200 USER is
2201 involved
2202 --exclude-target-project=EXCLUDE_TARGET_PROJECT
2203 exclude target project from request list
2204 --non-interactive
2205 non-interactive review of request
2206 --or-revoke
2207 For automation scripts: accepts (if using with
2208 accept
2209 argument) a request when it is in new or review
2210 state.
2211 Or revoke it when it got declined. Otherwise
2212 just do
2213 nothing.
2214 -i, --interactive
2215 interactive review of request
2216 -e, --edit edit a submit action
2217 -B, --bugowner
2218 also show requests about packages where I am
2219 bugowner
2220 -M, --mine only show requests created by yourself
2221 -b, --brief
2222 print output in list view as list subcommand
2223 -p PACKAGE, --package=PACKAGE
2224 requests or reviews limited for the specified
2225 PACKAGE,
2226 requires also a PROJECT
2227 -P PROJECT, --project=PROJECT
2228 requests or reviews limited for the specified
2229 PROJECT
2230 -G GROUP, --group=GROUP
2231 requests or reviews limited for the specified
2232 GROUP
2233 -U USER, --user=USER
2234 requests or reviews limited for the specified
2235 USER
2236 -D DAYS, --days=DAYS
2237 only list requests in state "new" or changed in
2238 the
2239 last DAYS. [default=0]
2240 -s STATE, --state=STATE
2241 only list requests in one of the comma separated
2242 given
2243 states (new/review/accepted/revoked/declined) or
2244 "all"
2245 [default="declined,new,review", or "all", if no
2246 args
2247 given]
2248 -f, --force
2249 enforce state change, can be used to ignore open
2250 reviews
2251 -a, --all all states. Same as'-s all'
2252 -t TYPE, --type=TYPE
2253 limit to requests which contain a given action
2254 type (s
2255 ubmit/delete/change_devel/add_role/set_bugowner/mainte
2256 nance_incident/maintenance_release)
2257 -m TEXT, --message=TEXT
2258 specify message TEXT
2259 --no-devel Do not attempt to forward to devel project
2260 -u, --unified
2261 output the diff in the unified diff format
2262 -d, --diff generate a diff
2263 requestmaintainership (reqbs, reqbugownership, reqmaintainership,
2267 reqms, requestbugownership)
2268 requests to add user as maintainer or bugowner
2269 usage:
2271 osc requestmaintainership # for
2272 current user in checked out package
2273 osc requestmaintainership USER # for
2274 specified user in checked out package
2275 osc requestmaintainership PROJECT # for
2276 current user if cwd is not a checked out package
2277 osc requestmaintainership PROJECT group:NAME #
2278 request for specified group
2279 osc requestmaintainership PROJECT PACKAGE # for
2280 current user
2281 osc requestmaintainership PROJECT PACKAGE USER #
2282 request for specified user
2283 osc requestmaintainership PROJECT PACKAGE group:NAME #
2284 request for specified group
2285 osc requestbugownership ... #
2287 accepts same parameters but uses bugowner role
2288 Options:
2290 -h, --help show this help message and exit
2291 -r role, --role=role
2292 specify user role (default: maintainer)
2293 -m TEXT, --message=TEXT
2294 specify message TEXT
2295 resolved
2299 Remove 'conflicted' state on working copy files
2300 If an upstream change can't be merged automatically, a file is
2302 put into in 'conflicted' ('C') state. Within the file, conflicts
2303 are marked with special <<<<<<< as well as ======== and >>>>>>>
2304 lines.
2305 After manually resolving all conflicting parts, use this command
2307 to remove the 'conflicted' state.
2308 Note: this subcommand does not semantically resolve conflicts
2310 or remove conflict markers; it merely removes the conflict-
2311 related artifact files and allows PATH to be committed again.
2312 usage:
2314 osc resolved FILE [FILE...]
2315 restartbuild (abortbuild)
2318 Restart the build of a certain project or package
2319 usage:
2321 osc restartbuild [PROJECT [PACKAGE [REPOSITORY [ARCH]]]]
2322 Options:
2323 -h, --help show this help message and exit
2324 --all Restart all running builds of entire project
2325 -r REPO, --repo=REPO
2326 Restart builds for a specific repository
2327 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2328 AGE
2329 Restart builds for specified multibuild package
2330 -a ARCH, --arch=ARCH
2331 Restart builds for a specific architecture
2332 results (r)
2336 Shows the build results of a package or project
2337 Usage:
2339 osc results # (inside working copy of PRJ or
2340 PKG)
2341 osc results PROJECT [PACKAGE]
2342 Options:
2344 -h, --help show this help message and exit
2345 --show-excluded
2346 show repos that are excluded for this package
2347 --format=FORMAT
2348 format string for csv output
2349 --csv generate output in CSV format
2350 --xml generate output in XML (former results_meta)
2351 -w, --watch
2352 watch the results until all finished building
2353 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2354 AGE
2355 Only show results for the specified multibuild
2356 package
2357 --no-multibuild
2358 Disable results for all direct affect packages
2359 inside
2360 of the project
2361 -v, --verbose
2362 more verbose output
2363 -a ARCH, --arch=ARCH
2364 Show results only for specified architecture(s)
2365 -r REPO, --repo=REPO
2366 Show results only for specified repo(s)
2367 -l, --last-build
2368 show last build results (suc‐
2369 ceeded/failed/unknown)
2370 revert Restore changed files or the entire working copy.
2374 Examples:
2376 osc revert <modified file(s)>
2377 osc revert . Note: this only works for package working
2378 copies
2379 Usage:
2381 osc revert [FILES...]
2382 rpmlintlog (lint, rpmlint)
2386 Shows the rpmlint logfile
2387 Shows the rpmlint logfile to analyse if there are any problems
2389 with the spec file and the built binaries.
2390 usage:
2392 osc rpmlintlog project package repository arch
2393 rremove
2396 Remove source files from selected package
2397 Usage:
2399 osc rremove PROJECT PACKAGE [FILES...]
2400 Options:
2402 -h, --help show this help message and exit
2403 -f, --force
2404 Don't ask and delete files
2405 search (bse, se)
2409 Search for a project and/or package.
2410 If no option is specified osc will search for projects and pack‐
2412 ages which contains the 'search term' in their name, title or
2413 description.
2414 usage:
2416 osc search 'search term' <options>
2417 osc bse ... ('osc search --binary')
2418 osc se 'perl(Foo::Bar)' ('osc search --package
2419 perl-Foo-Bar') Options:
2420 -h, --help show this help message and exit
2421 --binaryversion=VERSION
2422 search for binary with specified version
2423 (implies
2424 --binary)
2425 -B PROJECT, --baseproject=PROJECT
2426 search packages built for PROJECT (implies
2427 --binary)
2428 --binary search binary packages
2429 --csv generate output in CSV (separated by |)
2430 -M, --mine shorthand for --bugowner --package
2431 --maintained
2432 OBSOLETE: please use maintained command instead.
2433 -m, --maintainer
2434 as -i, but only maintainer
2435 -b, --bugowner
2436 as -i, but only bugowner
2437 -i, --involved
2438 show projects/packages where given person (or
2439 myself)
2440 is involved as bugowner or maintainer
2441 [[{group|person}/]<name>] default: person
2442 -V, --version
2443 show package version, revision, and srcmd5. CAU‐
2444 TION:
2445 This is slow and unreliable
2446 -v, --verbose
2447 show more information
2448 -a ATTRIBUTE, --limit-to-attribute=ATTRIBUTE
2449 match only when given attribute exists in meta
2450 data
2451 --description
2452 search for matches in the 'description' element
2453 --title search for matches in the 'title' element
2454 --project search for a project
2455 --package search for a package
2456 -s, --substring
2457 Show also results where the search term is a sub
2458 string, slower search
2459 -e, --exact
2460 show only exact matches, this is default now
2461 --repos-baseurl
2462 show base URLs of download repositories
2463 sendsysrq
2467 trigger a sysrq in a running build
2468 This is only going to work when the build is running in a sup‐
2470 ported VM. Also only a subset of sysrq are supported. Typical
2471 use case for debugging are 9, t and w in this sequence.
2472 usage:
2474 osc sendsysrq REPOSITORY ARCH SYSRQ
2475 osc sendsysrq PROJECT PACKAGE REPOSITORY ARCH SYSRQ Options:
2476 -h, --help show this help message and exit
2477 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2478 AGE
2479 specify a specific multibuild flavor
2480 service
2484 Handle source services
2485 Source services can be used to modify sources like downloading
2487 files, verify files, generating files or modify existing files.
2488 usage:
2490 osc service COMMAND (inside working copy)
2491 osc service run [SOURCE_SERVICE]
2492 osc service runall
2493 osc service localrun
2494 osc service disabledrun
2495 osc service remoterun [PROJECT PACKAGE]
2496 osc service merge [PROJECT PACKAGE]
2497 osc service wait [PROJECT PACKAGE]
2498 COMMAND can be:
2500 run r run defined services locally, it takes an
2501 optional parameter to run only a
2502 specified source service. In case parameters
2503 exist for this one in _service file
2504 they are used.
2505 runall ra run all services independent of the used mode
2506 localrun lr run all services except the ones with mode
2507 "buildtime", "disabled", or
2508 "serveronly" (deprecated)
2509 disabledrun dr run all services with mode "disabled" or
2510 "serveronly" (deprecated)
2511 remoterun rr trigger a re-run on the server side
2512 merge commits all server side generated files and
2513 drops the _service definition
2514 wait waits until the service finishes and returns
2515 with an error if it failed
2516 setdevelproject (sdp)
2520 Set the devel project / package of a package
2521 Examples:
2523 osc setdevelproject [PRJ PKG] DEVPRJ [DEVPKG] Options:
2524 -h, --help show this help message and exit
2525 -u, --unset
2526 remove devel project
2527 setlinkrev
2531 Updates a revision number in a source link.
2532 This command adds or updates a specified revision number in a
2534 source link. The current revision of the source is used, if no
2535 revision number is specified.
2536 usage:
2538 osc setlinkrev
2539 osc setlinkrev PROJECT [PACKAGE] Options:
2540 -h, --help show this help message and exit
2541 -u, --unset
2542 remove revision in link, it will point always to
2543 latest revision
2544 -R, --use-plain-revision
2545 Do not expand revision the specified or latest
2546 rev
2547 -r rev, --revision=rev
2548 use the specified revision.
2549 signkey
2553 Manage Project Signing Key
2554 osc signkey [--create|--delete|--extend] <PROJECT> osc signkey
2556 [--notraverse] <PROJECT>
2557 This command is for managing gpg keys. It shows the public key
2559 by default. There is no way to download or upload the private
2560 part of a key by design.
2561 However you can create a new own key. You may want to consider
2563 to sign the public key with your own existing key.
2564 If a project has no key, the key from upper level project will
2566 be used (e.g. when dropping "KDE:KDE4:Community" key, the one
2567 from "KDE:KDE4" will be used).
2568 WARNING: THE OLD KEY CANNOT BE RESTORED AFTER USING DELETE OR
2570 CREATE
2571 Usage:
2573 osc signkey [ARGS...]
2574 Options:
2576 -h, --help show this help message and exit
2577 --sslcert fetch SSL certificate instead of GPG key
2578 --notraverse
2579 don' traverse projects upwards to find key
2580 --delete delete the gpg signing key in this project
2581 --extend extend expiration date of the gpg public key for
2582 this
2583 project
2584 --create create new gpg signing key for this project
2585 status (st)
2589 Show status of files in working copy
2590 Show the status of files in a local working copy, indicating
2592 whether files have been changed locally, deleted, added, ...
2593 The first column in the output specifies the status and is one
2595 of the following characters:
2596 ' ' no modifications
2597 'A' Added
2598 'C' Conflicted
2599 'D' Deleted
2600 'M' Modified
2601 'R' Replaced (file was deleted and added again afterwards)
2602 '?' item is not under version control
2603 '!' item is missing (removed by non-osc command) or incomplete
2604 'S' item is skipped (item exceeds a file size limit or is
2605 _service:* file)
2606 'F' Frozen (use "osc pull" to merge conflicts) (package-only
2607 state)
2608 examples:
2610 osc st
2611 osc st <directory>
2612 osc st file1 file2 ...
2613 usage:
2615 osc status [OPTS] [PATH...] Options:
2616 -h, --help show this help message and exit
2617 -e, --show-excluded
2618 also show files which are excluded by the
2619 "exclude_glob" config option
2620 -v, --verbose
2621 print extra information
2622 -q, --quiet
2623 print as little as possible
2624 submitrequest (sr, submitpac, submitreq)
2628 Create request to submit source into another Project
2629 [See http://en.opensuse.org/openSUSE:Build_Service_Collaboration
2631 for information on this topic.]
2632 See the "request" command for showing and modifying existing
2634 requests.
2635 usage:
2637 osc submitreq [OPTIONS]
2638 osc submitreq [OPTIONS] DESTPRJ [DESTPKG]
2639 osc submitreq [OPTIONS] SOURCEPRJ SOURCEPKG DESTPRJ
2640 [DESTPKG]
2641 osc submitpac ... is a shorthand for osc submitreq --cleanup
2643 ...
2644 Options:
2646 -h, --help show this help message and exit
2647 --yes proceed without asking.
2648 -d, --diff show diff only instead of creating the actual
2649 request
2650 --update-link
2651 This transfers the source including the _link
2652 file.
2653 --no-update
2654 never touch source package on accept (will break
2655 source links)
2656 --no-cleanup
2657 never remove source package on accept, but
2658 update its
2659 content
2660 --cleanup remove package if submission gets accepted
2661 (default
2662 for home:<id>:branch projects)
2663 --seperate-requests
2664 Deprecated (wrong spelling - see --sepa‐
2665 rate-requests)
2666 --separate-requests
2667 Create multiple requests instead of a single one
2668 (when
2669 command is used for entire project)
2670 --nodevelproject
2671 do not follow a defined devel project (primary
2672 project
2673 where a package is developed)
2674 -s REQUEST_ID, --supersede=REQUEST_ID
2675 Superseding another request by this one
2676 -r REV, --revision=REV
2677 specify a certain source revision ID (the md5
2678 sum) for
2679 the source package
2680 -m TEXT, --message=TEXT
2681 specify message TEXT
2682 token Show and manage authentication token
2686 Authentication token can be used to run specific commands with‐
2688 out sending credentials.
2689 Usage:
2691 osc token
2692 osc token --create [--operation <OPERATION>] [<PROJECT>
2693 <PACKAGE>]
2694 osc token --delete <TOKENID>
2695 osc token --trigger <TOKENSTRING> [--operation <OPERATION>]
2696 [<PROJECT> <PACKAGE>] Options:
2697 -h, --help show this help message and exit
2698 -t TOKENSTRING, --trigger=TOKENSTRING
2699 Trigger the action of a token
2700 -o OPERATION, --operation=OPERATION
2701 Default is "runservice", but "release" or
2702 "rebuild"
2703 can also be used
2704 -d TOKENID, --delete=TOKENID
2705 Delete a token
2706 -c, --create
2707 Create a new token
2708 triggerreason (tr)
2712 Show reason why a package got triggered to build
2713 The server decides when a package needs to get rebuild, this
2715 command shows the detailed reason for a package. A brief reason
2716 is also stored in the jobhistory, which can be accessed via "osc
2717 jobhistory".
2718 Trigger reasons might be:
2720 - new build (never build yet or rebuild manually forced)
2721 - source change (e.g. on updating sources)
2722 - meta change (packages which are used for building have
2723 changed)
2724 - rebuild count sync (In case that it is configured to sync
2725 release numbers)
2726 usage in package or project directory:
2728 osc triggerreason REPOSITORY ARCH
2729 osc triggerreason PROJECT PACKAGE REPOSITORY ARCH
2730 Options:
2732 -h, --help show this help message and exit
2733 -M MPAC, --multibuild-package=MPAC
2734 get triggerreason of the specified multibuild
2735 package
2736 undelete
2740 Restores a deleted project or package on the server.
2741 The server restores a package including the sources and meta
2743 configuration. Binaries remain to be lost and will be rebuild.
2744 usage:
2746 osc undelete PROJECT
2747 osc undelete PROJECT PACKAGE [PACKAGE ...]
2748 Options:
2750 -h, --help show this help message and exit
2751 -m TEXT, --message=TEXT
2752 specify log message TEXT
2753 unlock Unlocks a project or package
2757 Unlocks a locked project or package. A comment is required.
2759 usage:
2761 osc unlock PROJECT [PACKAGE]
2762 Options:
2764 -h, --help show this help message and exit
2765 -m TEXT, --message=TEXT
2766 specify log message TEXT
2767 update (up)
2771 Update a working copy
2772 examples:
2774 1. osc up
2776 If the current working directory is a package, update
2777 it.
2778 If the directory is a project directory, update all con‐
2779 tained
2780 packages, AND check out newly added packages.
2781 To update only checked out packages, without checking
2783 out new
2784 ones, you might want to use "osc up *" from within the
2785 project
2786 dir.
2787 2. osc up PAC
2789 Update the packages specified by the path argument(s)
2790 When --expand-link is used with source link packages, the
2792 expanded sources will be checked out. Without this option, the
2793 _link file and patches will be checked out. The option --unex‐
2794 pand-link can be used to switch back to the "raw" source with a
2795 _link file plus patch(es).
2796 Usage:
2798 osc update [ARGS...]
2799 Options:
2801 -h, --help show this help message and exit
2802 -l limit_size, --limit-size=limit_size
2803 Skip all files with a given size
2804 -S, --server-side-source-service-files
2805 Use server side generated sources instead of
2806 local
2807 generation.
2808 -s, --source-service-files
2809 Run local source services after update.
2810 -e, --expand-link
2811 if a package is a link, update to the expanded
2812 sources
2813 -u, --unexpand-link
2814 if a package is an expanded link, update to the
2815 raw
2816 _link file
2817 --linkrev=REV
2818 revision of the link target that is used during
2819 link
2820 expansion
2821 -r REV, --revision=REV
2822 update to specified revision (this option will
2823 be
2824 ignored if you are going to update the complete
2825 project or more than one package)
2826 updatepacmetafromspec (metafromspec, updatepkgmetafromspec)
2830 Update package meta information from a specfile
2831 ARG, if specified, is a package working copy.
2833 Usage:
2835 osc updatepacmetafromspec [ARGS...]
2836 Options:
2838 -h, --help show this help message and exit
2839 --specfile=FILE
2840 Path to specfile. (if you pass more than working
2841 copy
2842 this option is ignored)
2843 vc Edit the changes file
2847 osc vc [-m MESSAGE|-e] [filename[.changes]|path [file_with_com‐
2849 ment]] If no <filename> is given, exactly one *.changes or
2850 *.spec file has to be in the cwd or in path.
2851 The email address used in .changes file is read from BuildSer‐
2853 vice instance, or should be defined in oscrc [https://api.open‐
2854 suse.org/] user = login pass = password email =
2855 user@defined.email
2856 or can be specified via mailaddr environment variable.
2858 Usage:
2860 osc vc [ARGS...]
2861 Options:
2863 -h, --help show this help message and exit
2864 -e, --just-edit
2865 just open changes (cannot be used with -m)
2866 -F FILE, --file=FILE
2867 read changes message from FILE (do not open an
2868 editor)
2869 -m MESSAGE, --message=MESSAGE
2870 add MESSAGE to changes (do not open an editor)
2871 whois (user, who)
2875 Show fullname and email of a buildservice user
2876 Usage:
2878 osc whois [USERNAMES...]
2879 wipebinaries (unpublish)
2883 Delete all binary packages of a certain project/package
2884 With the optional argument <package> you can specify a certain
2886 package otherwise all binary packages in the project will be
2887 deleted.
2888 usage:
2890 osc wipebinaries OPTS # works in
2891 checked out project dir
2892 osc wipebinaries OPTS PROJECT [PACKAGE]
2893 osc unpublish OPTS # works in checked
2894 out project dir
2895 osc unpublish OPTS PROJECT [PACKAGE] Options:
2896 -h, --help show this help message and exit
2897 --all Delete all binaries regardless of the package
2898 status
2899 (previously default)
2900 --unresolvable
2901 Delete all binaries of packages which have
2902 dependency
2903 errors
2904 --broken Delete all binaries of packages for which the
2905 package
2906 source is bad
2907 --build-failed
2908 Delete all binaries of packages for which the
2909 build
2910 failed
2911 --build-disabled
2912 Delete all binaries of packages for which the
2913 build is
2914 disabled
2915 -r REPO, --repo=REPO
2916 Delete all binary packages for a specific repos‐
2917 itory
2918 -M MULTIBUILD_PACKAGE, --multibuild-package=MULTIBUILD_PACK‐
2919 AGE
2920 Delete all binary packages for specified multi‐
2921 build
2922 package
2923 -a ARCH, --arch=ARCH
2924 Delete all binary packages for a specific archi‐
2925 tecture
2926 workerinfo
2930 gets the information to a worker from the server
2931 Examples:
2933 osc workerinfo <workername>
2934 Usage:
2936 osc workerinfo WORKER
2937 GLOBAL OPTIONS
2942 Options:
2943 --version show program's version number and exit
2944 -h, --help show this help message and exit
2945 --debugger jump into the debugger before executing any‐
2946 thing
2947 --post-mortem jump into the debugger in case of errors
2948 -t, --traceback print call trace in case of errors
2949 -H, --http-debug debug HTTP traffic (filters some headers)
2950 --http-full-debug debug HTTP traffic (filters no headers)
2951 -d, --debug print info useful for debugging
2952 -A URL/alias, --apiurl=URL/alias
2953 specify URL to access API server at or an alias
2954 -c FILE, --config=FILE
2955 specify alternate configuration file
2956 --no-keyring disable usage of desktop keyring system
2957 --no-gnome-keyring disable usage of GNOME Keyring
2958 -v, --verbose increase verbosity
2959 -q, --quiet be quiet, not verbose
2960
2964 Type 'osc help <subcommand>' for more detailed help on a specific sub‐
2965 command.
2966 For additional information, see
2968 * http://en.opensuse.org/openSUSE:Build_Service_Tutorial
2969 * http://en.opensuse.org/openSUSE:OSC
2970 You can modify osc commands, or roll your own, via the plugin API:
2972 * http://en.opensuse.org/openSUSE:OSC_plugins
2973
2975 osc was written by several authors. This man page is automatically gen‐
2976 erated.
2977osc 0.165.1 May 2019 OSC(1)