Αναφορά εντολών
Το JHBuild χρησιμοποιεί μια γραμμή εντολών με σύνταξη παρόμοια με εργαλεία όπως CVS:
jhbuild [global-options] command [command-arguments]
Οι καθολικές επιλογές του JHBuild είναι:
- -f, --file config
-
Χρησιμοποιήστε ένα εναλλακτικό αρχείο ρυθμίσεων αντί για το προεπιλεγμένο ~/.config/jhbuildrc.
- -m, --moduleset moduleset
-
Χρησιμοποιήστε μια ομάδα αρθρωμάτων άλλη από την ομάδα αρθρωμάτων που εμφανίζεται στο αρχείο ρυθμίσεων. Αυτή η επιλογή μπορεί να είναι μια σχετική διαδρομή αν η ομάδα αρθρωμάτων είναι τοποθετημένη στον φάκελο ομάδας αρθρωμάτων JHBuild, ή σε μια απόλυτη διαδρομή αν είναι τοποθετημένο αλλού.
- --no-interact
-
Να μην προτρέπεται στην χρήστη καμία εισαγωγή. Αυτή η επιλογή είναι χρήσιμη εάν αφήνετε μια αφύλακτη δόμηση, για να βεβαιωθείτε ότι η δόμηση δεν διακόπηκε.
- --exit-on-error
-
Exit immediately if a module fails to build. This option is primarily useful in noninteractive mode, in order to ensure jhbuild does not continue to build any additional modules.
- --conditions
-
Τροποιήστε τις σημαίες κατάστασης ώστε να είναι διαφορετικές από εκείνες που καθορίζονται με βάση το λειτουργικό σύστημα και από εκείνες που ορίζονται στο jhbuildrc. Οι τροποποιήσεις ορίζονται ως -wayland ή ως +docs ούτως ώστε να απομακρύνονται ή να προστίθενται καταστάσεις. Πολλαπλές τροποποιήσεις μπορούν να διαχωρίζονται με ένα κόμμα, όπως --conditions=+docs,-wayland ή μπορείτε να τις ξεχωρίσετε με τη βοήθεια πολλαπλών --conditions ορισμάτων.
Additionally, JHBuild checks the presence, and value, of the following environment variables:
- JHBUILD_RUN_AS_ROOT
-
By default, JHBuild does not run when using the root user, to avoid destructive operations that may affect the whole system. In certain cases, though, it's acceptable to run JHBuild as root; for instance, inside a container, or in a continuous integration environment. Exporting the JHBUILD_RUN_AS_ROOT will disable the user id check at startup.
Οι ειδικές επιλογές εντολής εμφανίζονται παρακάτω.
5.1. autobuild
Η εντολή autobuild δομεί αυτόματα τα αρθρώματα όπως ορίζονται στο αρχείο ρυθμίσεων και έπειτα ανεβάζει τα αποτελέσματα στο JhAutobuild.
jhbuild autobuild [--autogen] [--clean] [--distcheck] [--skip=module...] [--start-at=module] [--report-url=reporturl] [--verbose]
Οι επιλογές --autogen, --clean, --distcheck, --skip και --start-at επεξεργάζονται ανά εντολή build.
- --report-url=reporturl, -r reporturl
-
Αυτή η επιλογή καθορίζει τη διεύθυνση του JhAutobuild για αναφορά.
- --verbose, -v
-
Αν οριστεί, το αποτέλεσμα του JHBuild θα είναι πιο αναλυτικό.
5.2. bootstrap
Η εντολή bootstrap εγκαθιστά μια ομάδα εργαλείων δόμησης. Τα εργαλεία δόμησης περιλαμβάνουν τα autoconf, automake και παρόμοια εργαλεία. Η συνιστώμενη μέθοδος εγκατάστασης των εργαλείων δόμησης είναι μέσα από το σύστημα διαχείρισης πακέτων της διανομής σας. Το bootstrap πρέπει να χρησιμοποιηθεί μόνο αν τα εργαλεία δόμησης δεν παρέχονται από το σύστημα διαχείρισης πακέτων της διανομής σας, για παράδειγμα στο Mac OS.
jhbuild bootstrap
Η εντολή bootstrap δομεί αρθρώματα χρησιμοποιώντας την ίδια μέθοδο όπως η εντολή build, αλλά χρησιμοποιεί το σετ αρθρωμάτων bootstrap.modules.
Για διαθέσιμες επιλογές, δείτε την τεκμηρίωση της εντολής build.
5.3. build
Η εντολή build δομεί ένα ή περισσότερα πακέτα, συμπεριλαμβάνοντας τις εξαρτήσεις τους.
jhbuild build [--autogen] [--clean] [--check] [--dist] [--distcheck] [--distclean] [--ignore-suggests] [--no-network] [--skip=module...] [--start-at=module] [--tags=tags] [-D date] [--no-xvfb] [--try-checkout] [--no-poison] [--force] [--build-optional-modules] [--min-age=time] [--nodeps] [module...]
Εάν δεν παρέχονται ονόματα αρθρωμάτων στη γραμμή εντολών, θα χρησιμοποιηθεί η λίστα modules από το αρχείο ρυθμίσεων.
- -a, --autogen
-
Να εκτελείτε πάντα το autogen.sh πριν τη δόμηση αρθρωμάτων.
- -c, --clean
-
Να εκτελείτε το make clean πριν τη δόμηση αρθρωμάτων.
- --check
-
Να εκτελείτε το make check μετά τη δόμηση αρθρωμάτων.
- -d, --dist
-
Να εκτελείτε το make dist μετά τη δόμηση αρθρωμάτων.
- --distcheck
-
Να εκτελείτε το make distcheck μετά τη δόμηση αρθρωμάτων.
- --distclean
-
Για αρθρώματα git, να εκτελείτε git clean -dfx πριν τη δόμηση αρθρωμάτων. Για άλλα αρθρώματα, να εκτελείτε make distclean πριν τη δόμηση αρθρωμάτων.
This option will delete any uncommitted changes.
- --ignore-suggests
-
Να μην δομείτε χαλαρές εξαρτήσεις.
- -n, --no-network
-
Μην υπάρχει πρόσβαση στο δίκτυο κατά τη δόμηση αρθρωμάτων. Αυτό θα παραλείψει τη λήψη ή την ενημέρωση σταδίων σε μια δόμηση. Αν ένα άρθρωμα δεν μπορεί να δομηθεί χωρίς πρόσβαση δικτύου, η δόμηση του αρθρώματος θα αποτύχει.
- -s, --skip=module,...
-
Μη δομείτε τα αρθρώματα της λίστας. Χρησιμοποιούνται για να αποφύγουν τη δόμηση συγκεκριμένων εξαρτήσεων.
- --tags=tag,...
-
Αγνοήστε αρθρώματα που δεν ταιριάζουν με ετικέτες.Τα αρθρώματα αποδίδουν αυτόματα μια ετικέτα που ταιριάζει στο όνομα μιας ομάδας αρθρωμάτων του αρθρώματος.
- -t, --start-at=module
-
Ξεκινήστε με το καθορισμένο άρθρωμα αντί από την αρχή της λίστας. Αυτή η επιλογή είναι χρήσιμη αν η δόμηση διακόπηκε.
- -D date
-
Εάν υποστηρίζεται από το υποκείμενο σύστημα ελέγχου εκδόσεων, ενημερώστε το πηγαίο δένδρο στα συγκεκριμένη ημερομηνία πριν τη δόμηση. Απαιτείται μια μορφή ημερομηνίας ISO, π.χ. "2009-09-18 02:32Z".
- -x, --no-xvfb
-
Εκτελέστε δοκιμές γραφικών στον ενεργό εξυπηρετητή Χ αντί για τον προσομοιωμένο Xvfb.
- -C, --try-checkout
-
Εάν η δόμηση αποτύχει και αν υποστηρίζεται το σύστημα ελέγχου εκδόσεων, δημιουργήστε ένα αντίγραφο εργασίας και εκτελέστε το autogen.sh πριν ξαναδοκιμάσετε τη δόμηση.
- -N, --no-poison
-
Εάν μία ή περισσότερες εξαρτήσεις του αρθρώματος αποτύχουν, αυτή η επιλογή εξαναγκάζει το JHBuild να δοκιμάσει να δομήσει το άρθρωμα οπωσδήποτε.
- -f, --force
-
Δομήστε τα αρθρώματα ακόμα κι αν η πολιτική δηλώνει ότι δεν απαιτείται.
- --build-optional-modules
-
Τα σημειωμένα αρθρώματα ως προαιρετικές εξαρτήσεις, ίσως να μην απαιτούνται για τη δόμηση του αρθρώματος. Αυτή η επιλογή εξαναγκάζει το JHBuild να δομήσει προαιρετικές εξαρτήσεις.
- --min-age=time
-
Παραλείψτε τα αρθρώματα που εγκαταστάθηκαν πιο πρόσφατα από τον καθορισμένο σχετικό χρόνο. Η μορφή της συμβολοσειράς time είναι ένας αριθμός ακολουθούμενος από μια μονάδα. Υποστηρίζονται οι ακόλουθες μονάδες: δευτερόλεπτα (s), λεπτά (m), ώρες (h) και ημέρες (d). Για παράδειγμα, το --min-age=2h θα παραλείψει τα αρθρώματα που δομήθηκαν σε λιγότερο από δύο ώρες πριν.
- --nodeps
-
Αγνοήστε τις εξαρτήσεις του συστήματος που λείπουν. Για να αγνοήσετε μια μεμονωμένη εξάρτηση του συστήματος προσθέστε το άρθρωμα στο skip.
5.4. make
Η εντολή make είναι για ενεργή ανάπτυξη σε ένα ειδικό άρθρωμα. Απαιτεί ο τρέχων κατάλογος να είναι ένα αντίγραφο εργασίας πηγής και κάνει το ισοδύναμο του buildone -nf $(basename $(pwd)).
jhbuild make [--clean] [--check] [--distcheck] [--quiet]
Οι επιλογές είναι οι ίδιες με τις διαθέσιμες για την εντολή buildone.
5.5. buildone
Η εντολή buildone είναι παρόμοια με την build, αλλά δεν δομεί τα εξαρτημένα αρθρώματα. Είναι χρήσιμη για την αναδόμηση ενός ή περισσότερων αρθρωμάτων.
jhbuild buildone [--autogen] [--clean] [--check] [--distcheck] [--distclean] [--no-network] [-D date] [--no-xvfb] [--force] [--min-age=time] [--nodeps] module...
Οι επιλογές --autogen, --check, --clean, -d, --distcheck, --distclean, --no-network, -D, -x και --nodeps επεξεργάζονται όπως η εντολή build.
Τουλάχιστον ένα άρθρωμα πρέπει να είναι καταχωρισμένο στη γραμμή εντολών.
5.6. checkbranches
Η εντολή checkbranches ελέγχει τους κλάδους του αρθρώματος που ορίζονται σωστά μέσα στο σύστημα ελέγχου εκδόσεων και οι κλάδοι είναι συνεπείς με την ομάδα αρθρωμάτων.
jhbuild checkbranches [--branch=branch...]
- --branch=branch, -b branch
-
Ο κλάδος προς έλεγχο.
$ jhbuild -m gnome-2.20 checkbranches libgnomecanvas is missing branch definition for gnome-2-20 $
5.7. clean
Η εντολή clean καθαρίζει τους καταλόγους δόμησης ενός ή περισσότερων αρθρωμάτων.
jhbuild clean [--skip=module...] [--start-at=module]
Εάν δεν παρέχονται ονόματα αρθρωμάτων στη γραμμή εντολών, θα χρησιμοποιηθεί η λίστα modules από το αρχείο ρυθμίσεων.
Δείτε την τεκμηρίωση της εντολής build, για μια περιγραφή των διαθέσιμων επιλογών.
5.8. dot
Η εντολή dot παράγει ένα αρχείο που περιγράφει το κατευθυνόμενο γράφημα που σχηματίστηκε από τις εξαρτήσεις μεταξύ μιας ομάδας αρθρωμάτων. Αυτό το αρχείο μπορεί τότε να επεξεργαστεί χρησιμοποιώντας το λογισμικό GraphViz για να παραχθεί ένα διάγραμμα.
jhbuild dot [--soft-deps] [--clusters] [module...]
Εάν δεν παρέχονται ονόματα αρθρωμάτων στη γραμμή εντολών, θα χρησιμοποιηθεί η λίστα modules από το αρχείο ρυθμίσεων.
Η επιλογή --soft-deps προσθέτει διάστικτες γραμμές από τα αρθρώματα στις χαλαρές εξαρτήσεις. Η επιλογή --clusters ομαδοποιεί μαζί τα αρθρώματα από το metamodules.
Το αποτέλεσμα της εντολής dot μπορεί να διοχετευθεί στο εργαλείο dot για τη δημιουργία αρχείου PostScript:
$ jhbuild dot modules | dot -Tps > dependencies.ps
Ή μια εικόνα PNG:
$ jhbuild dot modules | dot -Tpng > dependencies.png
5.9. gui
Η εντολή gui ξεκινά μια γραφική διεπαφή στο JHBuild που μπορεί να χρησιμοποιηθεί για επιλογή αρθρωμάτων στη δόμηση και αλλαγή μερικών επιλογών.
jhbuild gui
Η γραφική διεπαφή αποδίδεται χρησιμοποιώντας GTK, έτσι απαιτούνται πρόσθετες βιβλιοθήκες υποστήριξης.
5.10. info
Η εντολή info εμφανίζει πληροφορίες για ένα ή περισσότερα αρθρώματα.
jhbuild info [--installed] [module...]
Η εντολή εμφανίζει το όνομα αρθρώματος, τύπο, εξαρτήσεις, εξαρτημένα πακέτα, τον πηγαίο κατάλογο και τον χρόνο που εγκαταστάθηκε τελευταία με JHBuild. Εάν είναι διαθέσιμες θα εμφανιστούν επίσης, ειδικές πληροφορίες για τον τύπο του αρθρώματος όπως το αποθετήριο CVS ή διεύθυνση λήψης.
Αν δεν υπάρχει συγκεκριμένο άρθρωμα η εντολή θα εμφανίσει πληροφορίες σχετικά με όλα τα αρθρώματα που ορίστηκαν στην ομάδα αρθρωμάτων.
If the --installed option is specified, the output will be filtered to include only installed packages. This resulting output only contains modules that were actually built and installed by jhbuild. The output does not include system dependencies.
If the --installed option is specified together with one or more module names, then only the installed modules (not including system dependencies) are printed out. If at least one module is not installed, then the command will exit with a return value of 1.
5.11. list
Η εντολή list εμφανίζει την εκτεταμένη λίστα των αρθρωμάτων που η εντολή build μπορεί να δομήσει.
jhbuild list [-a] [-r] [-s] [--start-at=module] [--tags=tags] [--ignore-suggests] [--list-optional-modules] [module...]
Εάν δεν παρέχονται ονόματα αρθρωμάτων στη γραμμή εντολών, θα χρησιμοποιηθεί η λίστα modules από το αρχείο ρυθμίσεων.
Οι επιλογές --skip, --start-at, --tags και --ignore-suggests επεξεργάζονται όπως η εντολή build.
- -a, --all-modules
-
Εμφανίστε όλα τα αρθρώματα από την ομάδα αρθρωμάτων, ανεξάρτητα από τις εξαρτήσεις δόμησης.
- -r, --show-revision
-
Εάν ένα άρθρωμα οριστεί σε έναν κλάδο, εμφανίστε το όνομα του κλάδου με το όνομα του αρθρώματος.
- --list-optional-modules
-
Αυτή η επιλογή εξαναγκάζει το JHBuild να εμφανίσει τις προαιρετικές εξαρτήσεις.
5.12. rdepends
Η εντολή rdepends εμφανίζει τις αντίστροφες εξαρτήσεις ενός αρθρώματος.
jhbuild rdepends [module]
- --dependencies
-
Εμφάνιση της διαδρομής εξάρτησης δίπλα στα αρθρώματα.
- --direct
-
Περιορίστε την εμφάνιση στα άμεσα αρθρώματα ανάλογα με το συγκεκριμένο άρθρωμα.
5.13. run
Η εντολή run εκτελεί τη συγκεκριμένη εντολή χρησιμοποιώντας το ίδιο περιβάλλον που χρησιμοποιεί το JHBuild όταν δομεί αρθρώματα.
jhbuild run [--in-builddir] [--in-checkoutdir] program [argument...]
Αν χρησιμοποιείτε JHBuild για να δομήσετε το GNOME, αυτή η εντολή μπορεί να είναι χρήσιμη σε scripts εκκίνησης Χ.
- --in-builddir=module
-
Εκτελέστε την εντολή στον κατάλογο δόμησης του καθορισμένου αρθρώματος.
- --in-checkoutdir=module
-
Εκτελέστε την εντολή στον πηγαίο κατάλογο του καθορισμένου αρθρώματος.
5.14. sanitycheck
Η εντολή sanitycheck εκτελεί έναν αριθμό ελέγχων για να επιβεβαιώσει ότι το περιβάλλον δόμησης είναι εντάξει.
jhbuild sanitycheck
Μερικοί από τους ελέγχους περιλαμβάνουν:
-
Η δημιουργία αντιγράφου εργασίας και η εγκατάσταση προθεμάτων είναι εγγράψιμα.
-
Τα απαιτούμενα εργαλεία δόμησης που είναι εγκατεστημένα.
-
Μερικές συνήθως χρησιμοποιούμενες μακροεντολές είναι διαθέσιμες στις διαδρομές αναζήτησης των εντολών aclocal που είναι συσχετισμένες με τις ποικίλες εκδόσεις του automake.
-
Ο κατάλογος XML περιέχει το DocBook DTD και φύλλα τεχνοτροπίας.
5.15. shell
Η εντολή shell ξεκινά το κέλυφος του χρήστη με το ίδιο περιβάλλον που χρησιμοποιεί το JHBuild όταν δομεί αρθρώματα.
jhbuild shell
Αυτή η εντολή είναι ισοδύναμη με την παρακάτω:
$ jhbuild run $SHELL
Η μεταβλητή περιβάλλοντος UNDER_JHBUILD θα οριστεί "true" όταν αυτό το κέλυφος είναι ενεργό. Μπορείτε να χρησιμοποιήσετε την παρουσία αυτής της μεταβλητής για να προσαρμόσετε την προτροπή του κελύφους για να δείξετε ότι είσαστε πραγματικά στο κέλυφος που ελέγχεται από το jhbuild. Για παράδειγμα, ίσως θέλετε να βάλετε αυτό στο .bashrc:
if [ -n "$UNDER_JHBUILD" ]; then PS1="[jhbuild] $PS1" fi
Αυτό θα προκαλέσει την εφάνιση του κέλυφους σας bash [jhbuild] πριν την κανονική σας προτροπή, καθιστώντας ευκολότερο να δείτε ποια κελύφη είναι σε περιβάλλον jhbuild.
5.16. sysdeps
Η εντολή sysdeps εμφανίζει:
-
μια λίστα των εγκατεστημένων πακέτων του συστήματος που θα χρησιμοποιηθεί κατά τη διάρκεια της δόμησης. Το JHBuild δεν θα δομήσει αυτά τα αρθρώματα και προαιρετικά θα χρησιμοποιήσει το πακέτο του συστήματος.
-
μια λίστα των απαιτούμενων πακέτων. Για την έναρξη της δόμησης τα πακέτα πρέπει να παρέχονται από το σύστημά σας.
-
μια λίστα των προαιρετικών πακέτων. Το αντίστοιχο πακέτο του συστήματος δεν βρέθηκε ή ήταν υπερβολικά παλιό. Το JHBuild θα δομήσει το άρθρωμα. Τα προαιρετικά πακέτα δεν θα εμφανιστούν αν η partial_build είναι False.
jhbuild sysdeps [--install]
- --install
-
Αυτή η επιλογή εγκαθιστά πακέτα του συστήματος που είναι εξαρτήσεις της ομάδα αρθρωμάτων. Η μέθοδος εγκατάστασης εξαρτάται από τη διανομή σας. Τα πακέτα του συστήματος εγκαθίστανται χρησιμοποιώντας το PackageKit, αν είναι διαθέσιμο. Για διανομές που χρησιμοποιούν APT όπως Debian και Ubuntu, αυτή η επιλογή απαιτεί το apt-file για να εγκατασταθεί.
$ jhbuild sysdeps System installed packages which are new enough: speex (speex.pc required=1.2rc1, installed=1.2rc1) lcms2 (lcms2.pc required=2.2, installed=2.2) ... Required packages: System installed packages which are too old: (none) No matching system package installed: zlib (zlib.pc required=1.2) Optional packages: (JHBuild will build the missing packages) System installed packages which are too old: WebKit (webkitgtk-3.0.pc required=1.5.1, installed=1.4.0) ... No matching system package installed: pulseaudio (libpulse.pc required=2.0) ...
5.17. tinderbox
Η εντολή tinderbox είναι παρόμοια με την build, αλλά γράφει όλα τα αποτελέσματα του τερματικού σε αρχεία HTML κατάλληλα για δημοσίευση σε έναν ιστότοπο. Μπορεί να χρησιμοποιηθεί για να ρυθμίσει συστήματα παρόμοια με το Tinderbox του Mozilla, ή το Buildd του Debian.
jhbuild tinderbox [--autogen] [--clean] [--distclean] [--no-network] [--output=directory] [--skip=module...] [--start-at=module] [-D date] [-C] [-N] [-f] [--nodeps] [module...]
Οι επιλογές --autogen, --clean, --distclean, --no-network, --skip, --start-at, -D, -C, -N, -f και --nodeps επεξεργάζονται όπως η εντολή build.
- -o, --output=directory
-
Ο κατάλογος για να γράψετε τα αρχεία HTML. Το JHBuild θα δημιουργήσει ένα ευρετήριο (index.html) και ένα αρχείο HTML για κάθε άρθρωμα.
5.18. uninstall
Η εντολή uninstall απεγκαθιστά ένα ή περισσότερα αρθρώματα.
jhbuild uninstall module...
5.19. update
Η εντολή update είναι παρόμοια με την εντολή build, αλλά εκτελεί μόνο τη λήψη ή την ενημέρωση του σταδίου για αρθρώματα χωρίς να τα δομήσει.
jhbuild update [--skip=module...] [--start-at=module] [--tags=tags] [--ignore-suggests] [-D date] [module...]
Οι επιλογές --skip, --start-at, --tags, --ignore-suggests και -D επεξεργάζονται όπως η εντολή build.
5.20. updateone
Η εντολή updateone είναι παρόμοια με την update, αλλά δεν ενημερώνει τα εξαρτημένα αρθρώματα. Είναι χρήσιμη για ενημέρωση ενός ή περισσότερων αρθρωμάτων.
jhbuild updateone [-D date] module...
Η επιλογή -D επεξεργάζεται όπως η εντολή build.
Τουλάχιστον ένα άρθρωμα πρέπει να είναι καταχωρισμένο στη γραμμή εντολών.