mozilla

Compare Revisions

Configuring Build Options

Change Revisions

Revision 22457:

Revision 22457 by DBaron on

Revision 22458:

Revision 22458 by Ted_Mielczarek on

Title:
Configuring Build Options
Configuring Build Options
Slug:
Configuring_Build_Options
Configuring_Build_Options
Tags:
NeedsTechnicalReview, NeedsMarkupWork, NeedsContent, NeedsEditorialReview, "Developing Mozilla", "Build documentation"
NeedsTechnicalReview, NeedsMarkupWork, NeedsContent, NeedsEditorialReview, "Developing Mozilla", "Build documentation"
Content:

Revision 22457
Revision 22458
t506    <h3 name="Complete_list_of_configure_options">t
507      Complete List of configure Options
508    </h3>
509    <p>
510      {{ Warning("Do not use a configure option unless you know w
>hat it does. The default values are usually the right ones.&nbsp; 
> Each additional option you add to your mozconfig file reduces th 
>e chance that your build will compile and run correctly.") }} 
511    </p>
512    <h4 name="Specific_to_testing_and.2For_profiling">
513      Specific to testing and/or profiling
514    </h4>
515    <ul>
516      <li>--{{ mediawiki.external('enable/disable') }}-profiling
517      </li>
518      <li>--{{ mediawiki.external('enable/disable') }}-codesighs
519      </li>
520      <li>--{{ mediawiki.external('enable/disable') }}-dtrace
521      </li>
522      <li>--{{ mediawiki.external('enable/disable') }}-glibtest
523      </li>
524      <li>--{{ mediawiki.external('enable/disable') }}-jprof
525      </li>
526      <li>--{{ mediawiki.external('enable/disable') }}-libIDLtest
527      </li>
528      <li>--{{ mediawiki.external('enable/disable') }}-logging
529      </li>
530      <li>--{{ mediawiki.external('enable/disable') }}-logrefcnt
531      </li>
532      <li>--{{ mediawiki.external('enable/disable') }}-perf-metri
>cs 
533      </li>
534      <li>--{{ mediawiki.external('enable/disable') }}-shark
535      </li>
536      <li>--{{ mediawiki.external('enable/disable') }}-tests
537      </li>
538    </ul>
539    <h4 name="Platform-specific_options">
540      Platform-specific Options
541    </h4>
542    <ul>
543      <li>--{{ mediawiki.external('enable/disable') }}-activex {{
> obsoleteGeneric("inline","gecko7.0") }} 
544      </li>
545      <li>--{{ mediawiki.external('enable/disable') }}-activex-sc
>ripting {{ obsoleteGeneric("inline","gecko7.0") }} 
546      </li>
547      <li>--{{ mediawiki.external('enable/disable') }}-macos-targ
>et=VER 
548      </li>
549      <li>--{{ mediawiki.external('enable/disable') }}-shark
550      </li>
551      <li>--with-macos-sdk=dir
552      </li>
553      <li>--{{ mediawiki.external('enable/disable') }}-os2-high-m
>em 
554      </li>
555      <li>--with-windows-version=MOZ_WINSDK_TARGETVER
556      </li>
557    </ul>
558    <h4 name="Other_Commonly_Used_Options">
559      System-Replacement Options
560    </h4>
561    <p>
562      These options are used to replace either some technology th
>at is provided by most platforms to Mozilla apps or some technolo 
>gy usually supplied as part of the Mozilla platform, with another 
> copy of that technology. If you do not see the point of this, or 
> do not&nbsp;understand how to replace one of these technologies, 
> just stay away from these options and things will be fine. 
563    </p>
564    <ul>
565      <li>--{{ mediawiki.external('enable/disable') }}-system-cai
>ro 
566      </li>
567      <li>--{{ mediawiki.external('enable/disable') }}-system-hun
>spell 
568      </li>
569      <li>--{{ mediawiki.external('enable/disable') }}-system-lcm
>s 
570      </li>
571      <li>--{{ mediawiki.external('enable/disable') }}-system-sql
>ite 
572      </li>
573      <li>--with-ft-exec-prefix=PFX
574      </li>
575      <li>--with-ft-prefix=PFX
576      </li>
577      <li>--with-glib-exec-prefix=PFX
578      </li>
579      <li>--with-glib-exec-prefix=PFX
580      </li>
581      <li>--with-glib-prefix=PFX
582      </li>
583      <li>--with-glib-prefix=PFX
584      </li>
585      <li>--with-java-bin-path=dir
586      </li>
587      <li>--with-java-include-path=dir
588      </li>
589      <li>--with-libIDL-exec-prefix=PFX
590      </li>
591      <li>--with-libIDL-prefix=PFX
592      </li>
593      <li>--with-libxul-sdk=PFX
594      </li>
595      <li>--with-nspr-exec-prefix=PFX
596      </li>
597      <li>--with-nspr-prefix=PFX
598      </li>
599      <li>--with-nss-exec-prefix=PFX
600      </li>
601      <li>--with-nss-prefix=PFX
602      </li>
603      <li>--with-system-bz2{{ mediawiki.external('=PFX') }}
604      </li>
605      <li>--with-system-jpeg{{ mediawiki.external('=PFX') }}
606      </li>
607      <li>--with-system-nspr
608      </li>
609      <li>--with-system-nss
610      </li>
611      <li>--with-system-png{{ mediawiki.external('=PFX') }}
612      </li>
613      <li>--with-system-zlib{{ mediawiki.external('=PFX') }}
614      </li>
615    </ul>
616    <h4 name="Other_options">
617      Other Commonly Used Options
618    </h4>
619    <ul>
620      <li>--{{ mediawiki.external('enable/disable') }}-applicatio
>n=APP - see <a href="#Choose_an_Application">above</a>. 
621      </li>
622      <li>--{{ mediawiki.external('enable/disable') }}-crashrepor
>ter - on by default, may cause problems on Linux builds. See info 
> in <a href="/En/Developer_Guide/Build_Instructions/Linux_Prerequ 
>isites" title="en/Linux_Build_Prerequisites">Linux Build Prerequi 
>sites</a>. 
623      </li>
624      <li>--{{ mediawiki.external('enable/disable') }}-debug{{ me
>diawiki.external('=DBG') }} - a master switch for debug output an 
>d other compilation and linking directives. 
625      </li>
626      <li>--{{ mediawiki.external('enable/disable') }}-javaxpcom
627      </li>
628      <li>--{{ mediawiki.external('enable/disable') }}-optimize
629      </li>
630      <li>--{{ mediawiki.external('enable/disable') }}-optimize={
>{ mediawiki.external('OPT') }} 
631      </li>
632      <li>--{{ mediawiki.external('enable/disable') }}-plugins
633      </li>
634      <li>--{{ mediawiki.external('enable/disable') }}-static
635      </li>
636      <li>--help - prints out a list of available options for the
> configure executable. 
637      </li>
638      <li>--with-pthreads
639      </li>
640    </ul>
641    <h4 name="Other_options">
642      Other Not&nbsp;So&nbsp;Commonly Used Options
643    </h4>
644    <ul>
645      <li>--{{ mediawiki.external('enable/disable') }}-accessibil
>ity - tested and works well in shipping software. This may not be 
> turned on in early versions, and so will be less stable. See the 
> mozilla.dev.accessibility newsgroup on news.mozilla.org for more 
> info. 
646      </li>
647    </ul>
648    <ul>
649      <li>--{{ mediawiki.external('enable/disable') }}-auto-deps
650      </li>
651      <li>--{{ mediawiki.external('enable/disable') }}-chrome-for
>mat=jar|flat|both|symlink|omni 
652      </li>
653      <li>--{{ mediawiki.external('enable/disable') }}-compile-en
>vironment 
654      </li>
655      <li>--{{ mediawiki.external('enable/disable') }}-composer
656      </li>
657      <li>--{{ mediawiki.external('enable/disable') }}-cpp-except
>ions 
658      </li>
659      <li>--{{ mediawiki.external('enable/disable') }}-cpp-rtti
660      </li>
661      <li>--{{ mediawiki.external('enable/disable') }}-crypto
662      </li>
663      <li>--{{ mediawiki.external('enable/disable') }}-dbus
664      </li>
665      <li>--{{ mediawiki.external('enable/disable') }}-default-to
>olkit=TK 
666      </li>
667      <li>--{{ mediawiki.external('enable/disable') }}-elf-dynstr
>-gc 
668      </li>
669      <li>--{{ mediawiki.external('enable/disable') }}-extensions
670      </li>
671      <li>--{{ mediawiki.external('enable/disable') }}-gnomeui
672      </li>
673      <li>--{{ mediawiki.external('enable/disable') }}-gnomevfs
674      </li>
675      <li>--{{ mediawiki.external('enable/disable') }}-help-viewe
>r 
676      </li>
677      <li>--{{ mediawiki.external('enable/disable') }}-image-enco
>ders{{ mediawiki.external('={mod1,mod2,default,all,none}') }} 
678      </li>
679      <li>--{{ mediawiki.external('enable/disable') }}-install-st
>rip 
680      </li>
681      <li>--{{ mediawiki.external('enable/disable') }}-installer
682      </li>
683      <li>--{{ mediawiki.external('enable/disable') }}-jemalloc
684      </li>
685      <li>--{{ mediawiki.external('enable/disable') }}-jit
686      </li>
687      <li>--{{ mediawiki.external('enable/disable') }}-js-static-
>build 
688      </li>
689      <li>--{{ mediawiki.external('enable/disable') }}-js-ultrasp
>arc 
690      </li>
691      <li>--{{ mediawiki.external('enable/disable') }}-jsd
692      </li>
693      <li>--{{ mediawiki.external('enable/disable') }}-ldap
694      </li>
695      <li>--{{ mediawiki.external('enable/disable') }}-ldap-exper
>imental 
696      </li>
697      <li>--{{ mediawiki.external('enable/disable') }}-leaky
698      </li>
699      <li>--{{ mediawiki.external('enable/disable') }}-mailnews
700      </li>
701      <li>--{{ mediawiki.external('enable/disable') }}-md
702      </li>
703      <li>--{{ mediawiki.external('enable/disable') }}-native-uco
>nv 
704      </li>
705      <li>--{{ mediawiki.external('enable/disable') }}-necko-disk
>-cache {{ obsolete_inline("8.0") }} 
706      </li>
707      <li>--{{ mediawiki.external('enable/disable') }}-necko-prot
>ocols{{ mediawiki.external('={http,ftp,default,all,none}') }} 
708      </li>
709      <li>--{{ mediawiki.external('enable/disable') }}-necko-smal
>l-buffers 
710      </li>
711      <li>--{{ mediawiki.external('enable/disable') }}-negotiatea
>uth 
712      </li>
713      <li>--{{ mediawiki.external('enable/disable') }}-official-b
>randing 
714      </li>
715      <li>--{{ mediawiki.external('enable/disable') }}-parental-c
>ontrols 
716      </li>
717      <li>--{{ mediawiki.external('enable/disable') }}-permission
>s 
718      </li>
719      <li>--{{ mediawiki.external('enable/disable') }}-places
720      </li>
721      <li>--{{ mediawiki.external('enable/disable') }}-plaintext-
>editor-only 
722      </li>
723      <li>--{{ mediawiki.external('enable/disable') }}-pref-exten
>sions 
724      </li>
725      <li>--{{ mediawiki.external('enable/disable') }}-printing
726      </li>
727      <li>--{{ mediawiki.external('enable/disable') }}-profile-gu
>ided-optimization 
728      </li>
729      <li>--{{ mediawiki.external('enable/disable') }}-profileloc
>king 
730      </li>
731      <li>--{{ mediawiki.external('enable/disable') }}-profilesha
>ring 
732      </li>
733      <li>--{{ mediawiki.external('enable/disable') }}-quantify
734      </li>
735      <li>--{{ mediawiki.external('enable/disable') }}-rdf
736      </li>
737      <li>--{{ mediawiki.external('enable/disable') }}-reflow-per
>f 
738      </li>
739      <li>--{{ mediawiki.external('enable/disable') }}-safe-brows
>ing 
740      </li>
741      <li>--{{ mediawiki.external('enable/disable') }}-startup-no
>tification 
742      </li>
743      <li>--{{ mediawiki.external('enable/disable') }}-static-mai
>l 
744      </li>
745      <li>--{{ mediawiki.external('enable/disable') }}-storage {{
> obsolete_inline("8.0") }} 
746      </li>
747      <li>--{{ mediawiki.external('enable/disable') }}-strip
748      </li>
749      <li>--{{ mediawiki.external('enable/disable') }}-timeline {
>{ obsolete_inline("8.0") }} 
750      </li>
751      <li>--{{ mediawiki.external('enable/disable') }}-trace-mall
>oc 
752      </li>
753      <li>--{{ mediawiki.external('enable/disable') }}-ui-locale=
>ab-CD 
754      </li>
755      <li>--{{ mediawiki.external('enable/disable') }}-universalc
>hardet 
756      </li>
757      <li>--{{ mediawiki.external('enable/disable') }}-update-cha
>nnel=CHANNEL 
758      </li>
759      <li>--{{ mediawiki.external('enable/disable') }}-update-pac
>kaging 
760      </li>
761      <li>--{{ mediawiki.external('enable/disable') }}-updater
762      </li>
763      <li>--{{ mediawiki.external('enable/disable') }}-url-classi
>fier 
764      </li>
765      <li>--{{ mediawiki.external('enable/disable') }}-v1-string-
>abi 
766      </li>
767      <li>--{{ mediawiki.external('enable/disable') }}-webservice
>s 
768      </li>
769      <li>--{{ mediawiki.external('enable/disable') }}-wrap-mallo
>c 
770      </li>
771      <li>--{{ mediawiki.external('enable/disable') }}-xmlextras
772      </li>
773      <li>--{{ mediawiki.external('enable/disable') }}-xpcom-fast
>load 
774      </li>
775      <li>--{{ mediawiki.external('enable/disable') }}-xpconnect-
>idispatch 
776      </li>
777      <li>--{{ mediawiki.external('enable/disable') }}-xpctools
778      </li>
779      <li>--{{ mediawiki.external('enable/disable') }}-xpfe-compo
>nents 
780      </li>
781      <li>--{{ mediawiki.external('enable/disable') }}-xpinstall
782      </li>
783      <li>--{{ mediawiki.external('enable/disable') }}-xprint
784      </li>
785      <li>--{{ mediawiki.external('enable/disable') }}-xterm-upda
>tes 
786      </li>
787      <li>--{{ mediawiki.external('enable/disable') }}-xtf
788      </li>
789      <li>--{{ mediawiki.external('enable/disable') }}-zipwriter
790      </li>
791      <li>--bindir=DIR
792      </li>
793      <li>--build=BUILD
794      </li>
795      <li>--cache-file=FILE
796      </li>
797      <li>--datadir=DIR
798      </li>
799      <li>--exec-prefix=EPREFIX
800      </li>
801      <li>--host=HOST - the --host, --target, and --prefix option
>s are used when cross-compiling. 
802      </li>
803      <li>--includedir=DIR
804      </li>
805      <li>--infodir=DIR
806      </li>
807      <li>--libdir=DIR
808      </li>
809      <li>--libexecdir=DIR
810      </li>
811      <li>--localstatedir=DIR
812      </li>
813      <li>--mandir=DIR
814      </li>
815      <li>--no-create
816      </li>
817      <li>--oldincludedir=DIR
818      </li>
819      <li>--prefix=PREFIX - the --host, --target, and --prefix op
>tions are used when cross-compiling. 
820      </li>
821      <li>--program-prefix=PREFIX
822      </li>
823      <li>--program-suffix=SUFFIX
824      </li>
825      <li>--program-transform-name=PROGRAM
826      </li>
827      <li>--quiet
828      </li>
829      <li>--sbindir=DIR
830      </li>
831      <li>--sharedstatedir=DIR
832      </li>
833      <li>--srcdir=DIR
834      </li>
835      <li>--sysconfdir=DIR
836      </li>
837      <li>--target=TARGET - the --host, --target, and --prefix op
>tions are used when cross-compiling. 
838      </li>
839      <li>--version
840      </li>
841      <li>--with-PACKAGE{{ mediawiki.external('=ARG') }}
842      </li>
843      <li>--with-branding=dir
844      </li>
845      <li>--with-default-mozilla-five-home
846      </li>
847      <li>--with-distribution-id=ID
848      </li>
849      <li>--with-doc-include-dirs=DIRS
850      </li>
851      <li>--with-doc-input-dirs=DIRS
852      </li>
853      <li>--with-doc-output-dir=DIR
854      </li>
855      <li>--with-user-appdir=DIR
856      </li>
857      <li>--with-wrap-malloc=DIR
858      </li>
859      <li>--with-x
860      </li>
861      <li>--with-xulrunner-stub-name=appname
862      </li>
863      <li>--without-PACKAGE
864      </li>
865      <li>--without-libIDL
866      </li>
867      <li>--x-includes=DIR
868      </li>
869      <li>--x-libraries=DIR
870      </li>
871    </ul>

Back to History