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