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