1OSC(1)                           User Commands                          OSC(1)
2
3
4

NAME

6       osc - openSUSE build service command-line tool.
7

SYNOPSIS

9       osc [GLOBALOPTS] SUBCOMMAND [OPTS] [ARGS...]
10       osc help SUBCOMMAND
11

DESCRIPTION

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

SEE ALSO

3077       Type  'osc help <subcommand>' for more detailed help on a specific sub‐
3078       command.
3079
3080       For additional information, see
3081        * http://en.opensuse.org/openSUSE:Build_Service_Tutorial
3082        * http://en.opensuse.org/openSUSE:OSC
3083
3084       You can modify osc commands, or roll your own, via the plugin API:
3085        * http://en.opensuse.org/openSUSE:OSC_plugins
3086

AUTHOR

3088       osc was written by several authors. This man page is automatically gen‐
3089       erated.
3090
3091
3092
3093osc 0.174                          Jul 2021                             OSC(1)
Impressum