Linux

PDFium 라이브러리 삽질기 - 1

respiro 2019. 12. 10. 14:36

PDFium 라이브러리 삽질기 - 1

정적 라이브러리로 빌드하기

작성일자: 2019년 12월 6일

최종수정: 2019년 12월 13일

작성자: N3

0. 개요

PDFium 은 Google 이 Chromium 에서 사용하는 것으로, Google 이 오픈소스로 공개하면서 널리 알려진 라이브러리다.

이 글은 CentOS 7 의 Mapserver 및 GDAL 에서 GeoPDF 를 출력하기 위해 PDFium 을 사용하기 위한 삽질기다.

PDFium은 C++로 작성되었으며, C 인터페이스 또한 제공하고 있다.

라이센스는 BSD 3-clause 라이센스다.

// Redistribution and use in source and binary forms, with or without

// modification, are permitted provided that the following conditions are

// met:

// * Redistributions of source code must retain the above copyright

// notice, this list of conditions and the following disclaimer.

// * Redistributions in binary form must reproduce the above

// copyright notice, this list of conditions and the following disclaimer

// in the documentation and/or other materials provided with the

// distribution.

// * Neither the name of Google Inc. nor the names of its

// contributors may be used to endorse or promote products derived from

// this software without specific prior written permission.

// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS

// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT

// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT

// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,

// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

왜 POPPLER 가 아닌 PDFium 인가?

https://libocon.org/assets/Conference/Tirana/PDFium-updated.pdf

1. 빌드 준비

PDFium 을 빌드하려면, Chromium 의 빌드 도구가 필요하며, 빌드 과정도 비슷하다.

빌드 및 다운로드 폴더 생성

$ mkdir PDFium

$ cd PDFium

google depot_tools 다운로드

$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

depot_tools 에는 PDFium 의 소스를 내려받고, 빌드하기 위한 파이썬 도구들이 들어있다.

대표적인 스크립트로는 gclient, gn, ninja 가 있다. 이 스크립트들은 git 소스를 내려받고, 빌드를 위한 환경을 생성하고, 빌드하기 위한 옵션들을 생성해는 도구들이다.

depot_tools 폴더를 PATH에 추가한다.

$ cd depot_tools

$ export $DEPOT_TOOLS=`pwd`

$ export PATH=$PATH:$DEPOT_TOOLS

$ cd ..

PDFium 소스 내려받기

git 으로 내려받는 것이 아니라, 앞에서 다운로드한 gclient 를 사용해서 소스를 내려받는다.

$ gclient config –-unmanaged https://pdfium.googlesource.com/pdfium.git

$ gclient sync -–verbose

$ ls

depot_tools pdfium

$ ls pdfium

git 으로 내려받는 것과 달리 gclient sync 로 내려받은 파일의 차이가 있다는 것을 알 수 있다.

$ git clone https://pdfium.googlesource.com/pdfium.git

git 으로 내려받은 소스에는 build 폴더와 빌드를 위한 스크립트가 없다는 것을 확인할 수 있다.

2. 빌드하기

PDFium( 또는 Chromium)을 빌드하기 위해 필요한 모든 것을 설치하는 스크립트로 install-build-deps.sh 이 있다.

[respiro@localhost PDFium]$ cd pdfium

[respiro@localhost pdfium]$ ls

AUTHORS LICENSE README.md build_overrides constants fpdfsdk navbar.md samples third_party xfa

BUILD.gn OWNERS base buildtools core fxbarcode pdfium.gni skia tools

DEPS PRESUBMIT.py build codereview.settings docs fxjs public testing v8

[respiro@localhost pdfium]$ ./build/install-build-deps.sh

which: no lsb_release in (/usr/local/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/home/respiro/.local/bin:/home/respiro/bin:/home/respiro/rpmbuild/SOURCES/PDFium/depot_tools)

ERROR: lsb_release not found in $PATH

기본 빌드 스크립트들이 모두 데비안을 위한 스크립트다.

"\tUbuntu 14.04 LTS (trusty with EoL April 2022)\n" \

"\tUbuntu 16.04 LTS (xenial with EoL April 2024)\n" \

"\tUbuntu 18.04 LTS (bionic with EoL April 2028)\n" \

"\tUbuntu 19.04 (disco)\n" \

"\tDebian 8 (jessie) or later" >&2

위 스크립트가 지원하는 배포판들이다. 일단 스크립트를 무시하고, 아규먼트 파일을 만들고 생성해 본다.

$ gn args out/First

# Build arguments go here.

# See "gn args <out_dir> --list" for available build arguments.

pdf_is_standalone = true # non-embedded 빌드 설정

is_debug = true # 디버깅

pdf_enable_xfa = true # XFA 지원

pdf_enable_v8 = true # 자바스크립트 v8 지원

pdf_use_skia = false # skia 백엔드 제거

pdf_use_skia_paths = false # skia 백엔드 제거

is_component_build = false # 컴포넌트 빌드 제거 (must be false)

clang_use_chrome_plugins = false # 크롬 플러그인 false.

아규먼트 파일을 저장한다.

$ cd out/First

$ ls

args.gn build.ninja build.ninja.d obj toolchain.ninja

조금 전 생성한 args.gn 과 소스파일의 BUILD.gn 파일을 이용해서 build.ninja등의 파일을 생성해서 ninja 빌드를 할 수 있도록 한다.

아규먼트 파일이 이미 있다면, args 옵션 대신에 gen 옵션을 사용할 수 있다.

$ mkdir -p out/First

$ cp args.gn out/First

$ gn gen out/First

ninja 는 일종의 래퍼 스크립트다.

$ ninja pdfium

[3/2765] CXX obj/buildtools/third_party/libc++/libc++/debug.o

FAILED: obj/buildtools/third_party/libc++/libc++/debug.o

../../third_party/llvm-build/Release+Asserts/bin/clang++ -MMD -MF obj/buildtools/third_party/libc++/libc++/debug.o.d -D_LIBCPP_BUILDING_LIBRARY -D_LIBCPP_OVERRIDABLE_FUNC_VIS=__attribute__$\(__visibility__\(\"default\"$\)\) -DLIBCXX_BUILDING_LIBCXXABI -DUSE_UDEV -DUSE_AURA=1 -DUSE_GLIB=1 -DUSE_NSS_CERTS=1 -DUSE_X11=1 -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_GNU_SOURCE -DCR_CLANG_REVISION=\"373424-64a362e7-2\" -D_LIBCPP_ABI_UNSTABLE -D_LIBCPP_DISABLE_VISIBILITY_ANNOTATIONS -D_LIBCXXABI_DISABLE_VISIBILITY_ANNOTATIONS -D_LIBCPP_ENABLE_NODISCARD -DCR_LIBCXX_REVISION=361348 -DCR_SYSROOT_HASH=e7c53f04bd88d29d075bfd1f62b073aeb69cbe09 -D_DEBUG -DDYNAMIC_ANNOTATIONS_ENABLED=1 -I../.. -Igen -fno-strict-aliasing --param=ssp-buffer-size=4 -fstack-protector -funwind-tables -fPIC -pthread -fcolor-diagnostics -fmerge-all-constants -fcrash-diagnostics-dir=../../tools/clang/crashreports -Xclang -mllvm -Xclang -instcombine-lower-dbg-declare=0 -fcomplete-member-pointers -m64 -march=x86-64 -Wno-builtin-macro-redefined -D__DATE__= -D__TIME__= -D__TIMESTAMP__= -Xclang -fdebug-compilation-dir -Xclang . -no-canonical-prefixes -O0 -fno-omit-frame-pointer -g2 -gsplit-dwarf -ggnu-pubnames -fvisibility=hidden -Wheader-hygiene -Wstring-conversion -Wtautological-overlap-compare -fstrict-aliasing -fPIC -Werror -Wall -Wno-unused-variable -Wno-missing-field-initializers -Wno-unused-parameter -Wno-c++11-narrowing -Wno-unneeded-internal-declaration -Wno-undefined-var-template -Wno-ignored-pragma-optimize -Wno-implicit-int-float-conversion -Wno-c99-designator -Wno-reorder-init-list -Wno-final-dtor-non-final-class -Wno-sizeof-array-div -Wno-undefined-bool-conversion -Wno-tautological-undefined-compare -std=c++14 -nostdinc++ -isystem../../buildtools/third_party/libc++/trunk/include -isystem../../buildtools/third_party/libc++abi/trunk/include --sysroot=../../build/linux/debian_sid_amd64-sysroot -fvisibility-inlines-hidden -fexceptions -frtti -c ../../buildtools/third_party/libc++/trunk/src/debug.cpp -o obj/buildtools/third_party/libc++/libc++/debug.o

../../third_party/llvm-build/Release+Asserts/bin/clang++: /lib64/libc.so.6: version `GLIBC_2.18' not found (required by /home/respiro/rpmbuild/SOURCES/PDFium/pdfium/third_party/llvm-build/Release+Asserts/bin/../lib/libstdc++.so.6)

[4/2765] CXX obj/buildtools/third_party/libc++/libc++/hash.o

third_party 의 clang++ 을 사용해서 빌드하고, 오류가 발생하는 것을 볼 수 있다.

toolchain.ninja 파일에 빌드에 사용하는 도구를 명시하고 있다.

third_party 의 폴더에는 llvm, clang 등의 도구가 더 들어 있다. 물론, CentOS 7 에서는 사용할 수 없다.

./clang: /lib64/libc.so.6: version `GLIBC_2.18' not found (required by /home/respiro/rpmbuild/SOURCES/PDFium/pdfium/third_party/llvm-build/Release+Asserts/bin/../lib/libstdc++.so.6)

생성한 ninja 파일에서 사용하는 clang 빌드 옵션이 CentOS 7 의 clang 3.9 버전보다 더 높은 사양을 요구한다.

CentOS 7 의 glibc 는 2.17 이다. CentOS 8 로 업그레이드해야한다. 그렇게 하기에는 시스템에서 옮겨야 할 것이 많으므로, 차라리 clang 과 llvm 을 먼저 업그레이드한다.

llvm 및 clang 업데이트 (불필요한 삽질)

CentOS 8, fedora29 또는 rhel8 의 llvm, clang, lld 의 소스 rpm 을 가져와서 다시 빌드한다.

SPEC 파일에서 python3 를 다음과 같이 수정한다. CentOS 7의 경우 python3 는 python34 또는 python36 이다.

BuildRequires: python%{python3_pkgversion}-sphinx

BuildRequires: python%{python3_pkgversion}-devel

make -O <== 에서 옵션 -O를 삭제한다.

$ rpmbuild -ba llvm.spec

또는 Fedora29 의 llvm-7.0.1-4 소스를 사용해도 된다.

fc29 의 llvm 은 ninja 로 빌드하기 때문에, 오히려 아래의 pdfium 을 빌드하기 위해 ninja 를 먼저 접해보는 것도 좋을 수 있다.

ninja 빌드 속도가 그렇게 빠르지는 않다.

$ time rpmbuild --rebuild llvm-7.0.1-3.el7.src.rpm

real 21m33.500s

user 205m20.212s

sys 26m7.622s

$ time rpmbuild --rebuild llvm-7.0.1-4.el7.src.rpm

real 22m35.076s

user 222m45.459s

sys 28m35.379s

llvm 과 lld 를 빌드 후 업데이트 한 후에, clang 을 빌드하고 설치한다.

clang 의 경우 spec 파일에 다음을 추가한다.

내부의 python 코드는 python3 에서 동작하지만, file=sys.stderr

CentOS7 의 python 은 디폴트로 python2 이며 rpm 패키징도 대부분 python2 코드기반으로 충돌한다.

패키징시 아래를 추가해서 python byte compile이 실패해도 패키징 오류가 나지 않도록 한다.

%global _python_bytecompile_errors_terminate_build 0

%global _pkgdocdir /usr/share/doc/clang

...

# Fix compat

mkdir -p %{_datadir}/clang/

install -p -m644 tools/clang-format/clang-format.py %{buildroot}%{_datadir}/clang/

install -p -m644 tools/clang-format/clang-format-diff.py %{buildroot}%{_datadir}/clang/

...

이제 toolchain.ninja 의 clang++ 의 경로를 바꾸거나, pdfium/third_party/llvm-build/Release+Asserts/bin/ 폴더의 실행파일들을 새로 빌드한 도구들로 변경해준다. 전자를 변경하면, 테스트 아규먼트 옵션 생성시 계속 수정해야 하기 때문에, third_party 의 clang 및 llvm 도구들의 경로를 수정한다.

$ cd ../../third_party/llvm-build/Release+Asserts/bin

$ ls

clang clang++ clang-cl ld.lld lld lld-link llvm-ar llvm-objcopy llvm-pdbutil llvm-symbolizer llvm-undname

$ rm -f llvm* lld clang

$ ln -s /usr/bin/llvm-ar .

$ ln -s /usr/bin/llvm-objcopy .

$ ln -s /usr/bin/llvm-pdbutil .

$ ln -s /usr/bin/llvm-symbolizer .

$ ln -s /usr/bin/llvm-undname .

$ ln -s /usr/bin/lld .

$ ln -s /usr/bin/clang .

다시 빌드해 본다.

$ cd ~/PDFium/out/First

$ ninja pdfium

...

error: unknown warning option '-Wno-implicit-int-float-conversion'; did you mean '-Wno-float-overflow-conversion'? [-Werror,-Wunknown-warning-option]

error: unknown warning option '-Wno-c99-designator'; did you mean '-Wno-gnu-designator'? [-Werror,-Wunknown-warning-option]

error: unknown warning option '-Wno-reorder-init-list' [-Werror,-Wunknown-warning-option]

error: unknown warning option '-Wno-final-dtor-non-final-class'; did you mean '-Wno-abstract-final-class'? [-Werror,-Wunknown-warning-option]

error: unknown warning option '-Wno-sizeof-array-div'; did you mean '-Wno-sizeof-array-decay'? [-Werror,-Wunknown-warning-option]

...

gcc 7.2 이상의 버전에서 사용하는 옵션들이 보인다.

is_clang = false

처음에 만든 args.gn 아규먼트 옵션 중에 clang 을 사용하지 않도록 하는 옵션이 있다는 것을 알게 되었다.

is_clang = false

옵션을 추가하고 다시 빌드해 본다.

g++: error: unrecognized command line option ‘-std=gnu++14’

gnu++14 옵션은 gcc 4.9(5.0) 이상에서 지원하는 옵션이다. CentOS 7 의 기본 gcc 4.8.5 다.

내용 추가

PDFium is transitioning to C++14, but still supports C++11 compatibility for the duration of the transition period. Prefer to use only C++11 features, though technically C++14 is allowed in code that is only built when V8, XFA, or Skia is turned on.

일단. v8, xfa, skia 관련 옵션은 모두 끄고 테스트한다.

use_cxx11 = true

is_clang = false

is_cfi = false

c++11 을 사용하기 위해서는 is_cfi 를 끄고 사용해야 한다. 잘 안된다.

아래처럼 그냥 scl 툴을 설치해서 해결한다.

CentOS 7 에서 gcc 7 / gcc 8 빌드 환경 구축하기 [feat. SCL 저장소]

# yum install centos-release-scl

# yum install devtoolset-7-gcc-c++

# yum install devtoolset-8-gcc-c++

$ scl enable devtoolset-7 bash

$ gcc --version

gcc (GCC) 7.3.1 20180303 (Red Hat 7.3.1-5)

This is free software; see the source for copying conditions. There is NO

warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

gcc 8 개발 환경을 사용하려면,

$ scl -l

devtoolset-7

devtoolset-8

llvm-toolset-7

$ scl enable devtoolset-8 bash

$ gcc --version

gcc (GCC) 8.3.1 20190311 (Red Hat 8.3.1-3)

This is free software; see the source for copying conditions. There is NO

warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

다시 빌드해 본다.

../../build/linux/debian_sid_amd64-sysroot/usr/include/features.h:424:12: fatal error: sys/cdefs.h: 그런 파일이나 디렉터리가 없습니다

# include <sys/cdefs.h>

리눅스 헤더들도 데비안스러운 것들을 끌고 오고 있다.

use_sysroot = false

헤메다가 아래 옵션을 발견했다. args.gn 에 다음 옵션을 추가한다.

use_sysroot = false

다시 빌드한다.

$ cd out/first

$ ninja pdfium

[1003/1003] STAMP obj/pdfium.stamp

다시 빌드한다.

$ ninja

[536/536] LINK ./zlib_bench

다시 빌드한다.

$ ninja

ninja: no work to do.

뭔가 컴파일을 하지만, 라이브러리가 생성되지 않는다.

뭔가 빠진 아규먼트들을 더 찾아서 이것저것 추가해 본다.

pdf_is_standalone = true # Set for a non-embedded build.

pdf_is_complete_lib=true

pdf_enable_xfa = false # XFA support enabled.

pdf_enable_v8 = false # Javascript support enabled.

pdf_use_skia = false # Avoid skia backend experiment.

pdf_use_skia_paths = false # Avoid other skia backend experiment.

pdf_bundle_freetype = true

clang_use_chrome_plugins = false

use_goma = false

use_custom_libcxx=false

use_sysroot = false

is_component_build = false

is_debug = true # Enable debugging features.

is_clang = false # Avoid dependency hell.

[respiro@localhost first]$ ninja pdfium

[1/1] Regenerating ninja files

[942/942] AR obj/libpdfium.a

드디서 obj 폴더아래에 libpdfium.a 를 만들었다.

3. 링크 테스트

간단한 컴파일 테스트를 해 본다.

pdf_hello.c

#include <stdio.h>

#include <fpdfview.h>

int main() {

FPDF_InitLibrary();

FPDF_DestroyLibrary();

printf("PDFium hello.\n");

return 0;

}

Makefile

PDFIUM= ../pdfium

INC_DIR= -I ${PDFIUM}/public

LIB_DIR= -L ${PDFIUM}/out/first/obj

PDF_LIBS= -lpdfium

STD_LIBS= -lpthread -lm -lc -lstdc++

default:

rm -f pdf_hello

gcc -o first first.c ${INC_DIR} ${LIB_DIR} ${PDF_LIBS} ${STD_LIBS}

테스트

[respiro@localhost test]$ make

rm -f pdf_hello

gcc -o pdf_hello pdf_hello.c -I ../pdfium/public -L ../pdfium/out/first/obj -lpdfium -lpthread -lm -lc -lstdc++

$ ./first

PDFium hello.

4. 시스템 라이브러리로 링크하기

소스를 살펴보면, third_party 폴더에 외부 라이브러리들이 있다.

third_party/BUILD.gn 파일을 보면 다음의 옵션을 사용해서 시스템의 라이브러리들을 사용할 수 있도록 되어 있다.

use_system_zlib = true

use_system_libpng = true

use_system_lcms2 = true

use_system_libjpeg = true

use_libjpeg_turbo = true

use_system_libopenjpeg2 = true

openjpeg 의 경우, 2.3 이상의 버전이 시스템에 설치된 경우가 아니라면, 임베드된 openjpeg 코드를 사용한다.

jpeg 의 경우, use_system_libjpeg과 use_libjpeg_turbo 를 모두 활성화해서 CentOS7 의 jpeg turbo 라이브러리를 링크하도록 한다.

임베드된 소스는 turbo_jpeg 이므로 시스템 라이브러리와 상관없이 use_libjpeg_turbo = true 로 항상 설정한다.

일단 시스템의 zlib 을 사용하도록 하고 다른 옵션은 막거나 제거해서 아규먼트를 수정해서 테스트 해본다.

앞에서 만든 테스트용 Makefile 을 실행해본다.

gcc -o pdf_hello pdf_hello.c -I ../pdfium/public -L ../pdfium/out/second/obj -lpdfium -lpthread -lm -lc -lstdc++

../pdfium/out/second/obj/libpdfium.a(flatemodule.o): In function `fxcodec::(anonymous namespace)::FlateCompress(unsigned char*, unsigned long*, unsigned char const*, unsigned int)':

/home/respiro/rpmbuild/SOURCES/PDFium/pdfium/out/second/../../core/fxcodec/flate/flatemodule.cpp:62: undefined reference to `compress'

../pdfium/out/second/obj/libpdfium.a(flatemodule.o): In function `fxcodec::(anonymous namespace)::FlateInit()':

/home/respiro/rpmbuild/SOURCES/PDFium/pdfium/out/second/../../core/fxcodec/flate/flatemodule.cpp:69: undefined reference to `inflateInit_'

../pdfium/out/second/obj/libpdfium.a(flatemodule.o): In function `fxcodec::(anonymous namespace)::FlateOutput(z_stream_s*, unsigned char*, unsigned int)':

/home/respiro/rpmbuild/SOURCES/PDFium/pdfium/out/second/../../core/fxcodec/flate/flatemodule.cpp:84: undefined reference to `inflate'

../pdfium/out/second/obj/libpdfium.a(flatemodule.o): In function `fxcodec::(anonymous namespace)::FlateEnd(z_stream_s*)':

/home/respiro/rpmbuild/SOURCES/PDFium/pdfium/out/second/../../core/fxcodec/flate/flatemodule.cpp:101: undefined reference to `inflateEnd'

collect2: error: ld returned 1 exit status

zlib 링크에 문제가 있음을 알 수 있다.

Makefile 에 시스템의 libz 를 링크하도록 추가한다.

STD_LIBS= -lpthread -lm -lc -lstdc++ -lz

다시 빌드하면 테스트 파일이 정상 동작함을 알 수 있다.

이런 식으로 앞에서 주석으로 처리한 다른 시스템 라이브러리들을 링크할 수 있다.

CentOS 7 에서는 다음의 패키지를 설치해서 사용할 수 있다.

# yum install libpng-devel zlib-devel openjpeg2-devel lcms2-devel libjpeg-turbo-devel

STD_LIBS= -lpthread -lm -lc -lstdc++ -lz -ljpeg -lopenjp2 -llcms2 -lpng

다음 삽질은 공유 라이브러리와 gdal 라이브러리 빌드를 위한 삽질이 된다.

추가 삽질뒤에 찾은 옵션이다. tiff 와 icu 라이브러리를 시스템 라이브러리로 사용하는 옵션은 아직 찾지 못했다.

use_system_freetype = true

pdf_bundle_freetype = false

freetype 을 시스템 라이브러리로 사용하기 위해서는 third_party/freetype 을 사용하지 않도록 pdf_bundle_freetype 을 사용하지 않도록 해야 한다.

PDFIUM= ../pdfium

INC_DIR= -I ${PDFIUM}/public

LIB_DIR= -L ${PDFIUM}/out/first/obj

PDF_LIBS= -lpdfium

STD_LIBS= -lpthread -lm -lc -lstdc++-lz -ljpeg -lopenjp2 -llcms2 -lpng -lfreetype

default:

rm -f pdf_hello

gcc -o first first.c ${INC_DIR} ${LIB_DIR} ${PDF_LIBS} ${STD_LIBS}

5. 아규먼트 목록 출력하기

앞서 사용한 아규먼트들의 목록을 보려면, 다음과 같이 한다.

$ cd pdfium

$ gn args out/first --list

action_pool_depth

Current value (from the default) = -1

From //build/toolchain/BUILD.gn:10

Pool for non goma tasks.

android_full_debug

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:53

Normally, Android builds are lightly optimized, even for debug builds, to

keep binary size down. Setting this flag to true disables such optimization

archive_seed_corpus

Current value (from the default) = true

From //build/config/sanitizers/sanitizers.gni:117

When true, seed corpora archives are built.

asan_globals

Current value (from the default) = true

From //build/config/sanitizers/sanitizers.gni:166

Detect overflow/underflow for global objects.

Mac: http://crbug.com/352073

asan_use_blacklist

Current value (from the default) = true

From //build/config/sanitizers/sanitizers.gni:109

Use blacklists from tools/memory/asan when compiling with asan.

auto_profile_path

Current value (from the default) = ""

From //build/config/compiler/BUILD.gn:89

AFDO (Automatic Feedback Directed Optimizer) is a form of profile-guided

optimization that GCC supports. It used by ChromeOS in their official

builds. To use it, set auto_profile_path to the path to a file containing

the needed gcov profiling data.

binutils_path

Current value (from the default) = "../../third_party/binutils/Linux_x64/Release/bin"

From //build/config/compiler/BUILD.gn:62

cast_is_debug

Current value (from the default) = false

From //build/config/chromecast_build.gni:16

If true, IS_CAST_DEBUG_BUILD() will evaluate to 1 in version.h. Otherwise,

it will evaluate to 0. Overriding this when is_debug=false is useful for

doing engineering builds.

cc_wrapper

Current value (from the default) = ""

From //build/toolchain/cc_wrapper.gni:36

Set to "ccache", "icecc" or "distcc". Probably doesn't work on windows.

chrome_pgo_phase

Current value (from the default) = 0

From //build/config/compiler/pgo/pgo.gni:13

Specify the current PGO phase.

Here's the different values that can be used:

0 : Means that PGO is turned off.

1 : Used during the PGI (instrumentation) phase.

2 : Used during the PGO (optimization) phase.

TODO(sebmarchand): Add support for the PGU (update) phase.

chromecast_branding

Current value (from the default) = "public"

From //build/config/chromecast_build.gni:20

chromecast_branding is used to include or exclude Google-branded components.

Set it to "public" for a Chromium build.

chromeos_afdo_platform

Current value (from the default) = "silvermont"

From //build/config/compiler/BUILD.gn:111

This configuration is used to select a default profile in Chrome OS based on

the microarchitectures we are using. This is only used if

clang_use_default_sample_profile is true and clang_sample_profile_path is

empty.

clang_base_path

Current value (from the default) = "//third_party/llvm-build/Release+Asserts"

From //build/config/clang/clang.gni:14

clang_emit_debug_info_for_profiling

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:114

Emit debug information for profiling wile building with clang.

clang_sample_profile_path

Current value (from the default) = ""

From //build/config/compiler/BUILD.gn:96

Path to an AFDO profile to use while building with clang, if any. Empty

implies none.

clang_use_chrome_plugins

Current value = false

From //out/first/args.gn:12

Overridden from the default = false

From //build/config/clang/clang.gni:12

Indicates if the build should use the Chrome-specific plugins for enforcing

coding guidelines, etc. Only used when compiling with Clang.

clang_use_default_sample_profile

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:104

Some configurations have default sample profiles. If this is true and

clang_sample_profile_path is empty, we'll fall back to the default.

We currently only have default profiles for Chromium in-tree, so we disable

this by default for all downstream projects, since these profiles are likely

nonsensical for said projects.

compiler_timing

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:117

Turn this on to have the compiler output extra timing information.

concurrent_links

Current value (from the default) = -1

From //build/toolchain/concurrent_links.gni:19

Limit the number of concurrent links; we often want to run fewer

links at once than we do compiles, because linking is memory-intensive.

The default to use varies by platform and by the amount of memory

available, so we call out to a script to get the right value.

coverage_instrumentation_input_file

Current value (from the default) = ""

From //build/config/coverage/coverage.gni:29

The path to the coverage instrumentation input file should be a source root

absolute path (e.g. //out/Release/coverage_instrumentation_input.txt), and

the file consists of multiple lines where each line represents a path to a

source file, and the paths must be relative to the root build directory.

e.g. ../../base/task/post_task.cc for build directory 'out/Release'.

NOTE that this arg will be non-op if use_clang_coverage is false.

current_cpu

Current value (from the default) = ""

(Internally set; try `gn help current_cpu`.)

current_os

Current value (from the default) = ""

(Internally set; try `gn help current_os`.)

custom_toolchain

Current value (from the default) = ""

From //build/config/BUILDCONFIG.gn:144

Allows the path to a custom target toolchain to be injected as a single

argument, and set as the default toolchain.

dcheck_always_on

Current value (from the default) = false

From //build/config/dcheck_always_on.gni:14

Set to true to enable dcheck in Release builds.

dcheck_is_configurable

Current value (from the default) = false

From //build/config/dcheck_always_on.gni:9

Enables DCHECKs to be built-in, but to default to being non-fatal/log-only.

DCHECKS can then be set as fatal/non-fatal via the DCheckIsFatal feature.

See crbug.com/596231 for details on how this is used.

disable_libfuzzer

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:92

Helper variable for testing builds with disabled libfuzzer.

Not for client use.

enable_callgrind

Current value (from the default) = false

From //pdfium.gni:57

Enable callgrind for performance profiling

enable_cast_renderer

Current value (from the default) = false

From //build/config/chromecast_build.gni:46

True to enable the cast renderer. It is enabled by default for non-android

builds.

enable_full_stack_frames_for_profiling

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:70

Compile in such a way as to make it possible for the profiler to unwind full

stack frames. Setting this flag has a large effect on the performance of the

generated code than just setting profiling, but gives the profiler more

information to analyze.

Requires profiling to be set to true.

enable_iterator_debugging

Current value (from the default) = false

From //build/config/BUILD.gn:40

When set (the default) enables C++ iterator debugging in debug builds.

Iterator debugging is always off in release builds (technically, this flag

affects the "debug" config, which is always available but applied by

default only in debug builds).

Iterator debugging is generally useful for catching bugs. But it can

introduce extra locking to check the state of an iterator against the state

of the current object. For iterator- and thread-heavy code, this can

significantly slow execution - two orders of magnitude slowdown has been

seen (crbug.com/903553) and iterator debugging also slows builds by making

generation of snapshot_blob.bin take ~40-60 s longer. Therefore this

defaults to off.

enable_precompiled_headers

Current value (from the default) = true

From //build/config/pch.gni:11

Precompiled header file support is by default available,

but for distributed build system uses (like goma) or when

doing official builds.

enable_profiling

Current value (from the default) = false

From //build/config/compiler/compiler.gni:48

Compile in such a way as to enable profiling of the generated code. For

example, don't omit the frame pointer and leave in symbols.

enable_resource_whitelist_generation

Current value (from the default) = false

From //build/toolchain/gcc_toolchain.gni:27

fatal_linker_warnings

Current value (from the default) = true

From //build/config/compiler/BUILD.gn:78

Enable fatal linker warnings. Building Chromium with certain versions

of binutils can cause linker warning.

forbid_non_component_debug_builds

Current value (from the default) = false

From //build/config/compiler/compiler.gni:89

Whether an error should be raised on attempts to make debug builds with

is_component_build=false. Very large debug symbols can have unwanted side

effects so this is enforced by default for chromium.

force_local_build_id

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:139

By default only the binaries in official builds get build IDs.

full_wpo_on_official

Current value (from the default) = false

From //build/config/compiler/compiler.gni:183

gcc_target_rpath

Current value (from the default) = ""

From //build/config/gcc/BUILD.gn:19

When non empty, overrides the target rpath value. This allows a user to

make a Chromium build where binaries and shared libraries are meant to be

installed into separate directories, like /usr/bin/chromium and

/usr/lib/chromium for instance. It is useful when a build system that

generates a whole target root filesystem (like Yocto) is used on top of gn,

especially when cross-compiling.

Note: this gn arg is similar to gyp target_rpath generator flag.

generate_linker_map

Current value (from the default) = false

From //build/toolchain/toolchain.gni:26

Used for binary size analysis.

generate_order_files

Current value (from the default) = false

From //build/config/chrome_build.gni:17

Turn this on to generate order files. See

https://chromium.googlesource.com/chromium/src/+/master/docs/win_order_files.md

gold_path

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:74

When we are going to use gold we need to find it.

This is initialized below, after use_gold might have been overridden.

goma_dir

Current value (from the default) = "/home/respiro/goma"

From //build/toolchain/goma.gni:26

Absolute directory containing the gomacc binary.

has_gomacc_path

Current value (from the default) = false

From //build/toolchain/goma.gni:14

This flag is for ChromeOS compiler wrapper.

By passing gomacc path via GOMACC_PATH environment variable, ChromeOS'

compiler wrapper invokes gomacc inside it.

host_byteorder

Current value (from the default) = "undefined"

From //build/config/host_byteorder.gni:9

host_cpu

Current value (from the default) = "x64"

(Internally set; try `gn help host_cpu`.)

host_os

Current value (from the default) = "linux"

(Internally set; try `gn help host_os`.)

host_pkg_config

Current value (from the default) = ""

From //build/config/linux/pkg_config.gni:36

A optional pkg-config wrapper to use for tools built on the host.

host_toolchain

Current value (from the default) = ""

From //build/config/BUILDCONFIG.gn:148

This should not normally be set as a build argument. It's here so that

every toolchain can pass through the "global" value via toolchain_args().

hwasan_platform

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:21

Specify whether to target the platform's copy of the HWASan runtime,

rather than one bundled with the application.

icu_use_data_file

Current value (from the default) = true

From //third_party/icu/config.gni:8

Tells icu to load an external data file rather than rely on the icudata

being linked directly into the binary.

ignore_elf32_limitations

Current value (from the default) = false

From //build_overrides/build.gni:42

Android 32-bit non-component, non-clang builds cannot have symbol_level=2

due to 4GiB file size limit, see https://crbug.com/648948.

Set this flag to true to skip the assertion.

init_stack_vars

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:145

Initialize all local variables with a pattern. This flag will fill uninitialized

floating-point types (and 32-bit pointers) with 0xFF and the rest with 0xAA.

This allows to make behavior of uninitialized memory bugs consistent, easier to

recognize when debugging and often just to crash immediately.

ios_deployment_target

Current value (from the default) = "12.0"

From //build/config/ios/ios_sdk_overrides.gni:10

Version of iOS that we're targeting.

is_asan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:12

Compile for Address Sanitizer to find memory bugs.

is_cast_audio_only

Current value (from the default) = false

From //build/config/chromecast_build.gni:23

Set this true for an audio-only Chromecast build.

is_cast_desktop_build

Current value (from the default) = false

From //build/config/chromecast_build.gni:39

True if Chromecast build is targeted for linux desktop. This type of build

is useful for testing and development, but currently supports only a subset

of Cast functionality. Though this defaults to true for x86 Linux devices,

this should be overriden manually for an embedded x86 build.

TODO(slan): Remove instances of this when x86 is a fully supported platform.

is_cfi

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:58

Compile with Control Flow Integrity to protect virtual calls and casts.

See http://clang.llvm.org/docs/ControlFlowIntegrity.html

TODO(pcc): Remove this flag if/when CFI is enabled in all official builds.

is_chrome_branded

Current value (from the default) = false

From //build/config/chrome_build.gni:9

Select the desired branding flavor. False means normal Chromium branding,

true means official Google Chrome branding (requires extra Google-internal

resources).

is_chromecast

Current value (from the default) = false

From //build/config/chromecast_build.gni:11

Set this true for a Chromecast build. Chromecast builds are supported on

Linux and Android.

is_clang

Current value = false

From //out/first/args.gn:20

Overridden from the default = true

From //build/config/BUILDCONFIG.gn:137

Set to true when compiling with the Clang compiler.

is_component_build

Current value = false

From //out/first/args.gn:18

Overridden from the default = false

From //build/config/BUILDCONFIG.gn:165

Component build. Setting to true compiles targets declared as "components"

as shared libraries loaded dynamically. This speeds up development time.

When false, components will be linked statically.

For more information see

https://chromium.googlesource.com/chromium/src/+/master/docs/component_build.md

is_debug

Current value = false

From //out/first/args.gn:19

Overridden from the default = true

From //build/config/BUILDCONFIG.gn:155

Debug build. Enabling official builds automatically sets is_debug to false.

is_desktop_linux

Current value (from the default) = true

From //build/config/BUILDCONFIG.gn:134

Whether we're a traditional desktop unix.

is_hwasan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:17

Compile for Hardware-Assisted Address Sanitizer to find memory bugs

(android/arm64 only).

See http://clang.llvm.org/docs/HardwareAssistedAddressSanitizerDesign.html

is_lsan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:24

Compile for Leak Sanitizer to find leaks.

is_msan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:27

Compile for Memory Sanitizer to find uninitialized reads.

is_multi_dll_chrome

Current value (from the default) = false

From //build/config/chrome_build.gni:13

Break chrome.dll into multple pieces based on process type. Only available

on Windows.

is_official_build

Current value (from the default) = false

From //build/config/BUILDCONFIG.gn:131

Set to enable the official build level of optimization. This has nothing

to do with branding, but enables an additional level of optimization above

release (!is_debug). This might be better expressed as a tri-state

(debug, release, official) but for historical reasons there are two

separate flags.

is_tsan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:30

Compile for Thread Sanitizer to find threading bugs.

is_ubsan

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:34

Compile for Undefined Behaviour Sanitizer to find various types of

undefined behaviour (excludes vptr checks).

is_ubsan_no_recover

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:37

Halt the program if a problem is detected.

is_ubsan_null

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:40

Compile for Undefined Behaviour Sanitizer's null pointer checks.

is_ubsan_security

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:88

Enables core ubsan security features. Will later be removed once it matches

is_ubsan.

is_ubsan_vptr

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:43

Compile for Undefined Behaviour Sanitizer's vptr checks.

is_win_fastlink

Current value (from the default) = false

From //build/config/compiler/compiler.gni:73

Tell VS to create a PDB that references information in .obj files rather

than copying it all. This should improve linker performance. mspdbcmf.exe

can be used to convert a fastlink pdb to a normal one.

ldso_path

Current value (from the default) = ""

From //build/config/gcc/BUILD.gn:20

libcxx_is_shared

Current value (from the default) = false

From //build/config/c++/c++.gni:44

WARNING: Setting this to a non-default value is highly discouraged.

If true, libc++ will be built as a shared library; otherwise libc++ will be

linked statically. Setting this to something other than the default is

unsupported and can be broken by libc++ rolls. Note that if this is set to

true, you must also set libcxx_abi_unstable=false, which is bad for

performance and memory use.

libcxx_natvis_include

Current value (from the default) = true

From //build/config/c++/c++.gni:30

Builds libcxx Natvis into the symbols for type visualization.

Set to false to workaround http://crbug.com/966676 and

http://crbug.com/966687.

linux_use_bundled_binutils

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:60

llvm_force_head_revision

Current value (from the default) = false

From //build/toolchain/toolchain.gni:18

If this is set to true, or if LLVM_FORCE_HEAD_REVISION is set to 1

in the environment, we use the revision in the llvm repo to determine

the CLANG_REVISION to use, instead of the version hard-coded into

//tools/clang/scripts/update.py. This should only be used in

conjunction with setting LLVM_FORCE_HEAD_REVISION in the

environment when `gclient runhooks` is run as well.

mac_sdk_min

Current value (from the default) = "10.14"

From //build/config/mac/mac_sdk_overrides.gni:12

max_jobs_per_link

Current value (from the default) = 8

From //build/config/compiler/compiler.gni:68

Limit the number of jobs (threads/processes) the linker is allowed

to use (for linkers that support this).

msan_track_origins

Current value (from the default) = 2

From //build/config/sanitizers/sanitizers.gni:48

Track where uninitialized memory originates from. From fastest to slowest:

0 - no tracking, 1 - track only the initial allocation site, 2 - track the

chain of stores leading from allocation site to use site.

optimize_for_fuzzing

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:96

Optimize for coverage guided fuzzing (balance between speed and number of

branches). Can be also used to remove non-determinism and other issues.

pdf_bundle_freetype

Current value = true

From //out/first/args.gn:10

Overridden from the default = true

From //pdfium.gni:16

Build PDFium either:

1) When set to true, with a bundled FreeType, built from FreeType source

code in //third_party/freetype and PDFium's FreeType configs in

third_party/freetype/include.

2) When set to false, use whatever FreeType target is defined in

//build/config/freetype.

pdf_enable_click_logging

Current value (from the default) = false

From //pdfium.gni:19

Generate logging messages for click events that reach PDFium

pdf_enable_v8

Current value = false

From //out/first/args.gn:6

Overridden from the default = true

From //pdfium.gni:22

Build PDFium either with or without v8 support.

pdf_enable_xfa

Current value = false

From //out/first/args.gn:5

Overridden from the default = false

From //pdfium.gni:25

Build PDFium either with or without XFA Forms support.

pdf_enable_xfa_bmp

Current value (from the default) = true

From //pdfium.gni:28

If XFA, also support bmp codec. Ignored if not XFA.

pdf_enable_xfa_gif

Current value (from the default) = true

From //pdfium.gni:31

If XFA, also support gif codec. Ignored if not XFA.

pdf_enable_xfa_png

Current value (from the default) = true

From //pdfium.gni:34

If XFA, also support png codec. Ignored if not XFA.

pdf_enable_xfa_tiff

Current value (from the default) = true

From //pdfium.gni:37

If XFA, also support png codec. Ignored if not XFA.

pdf_is_complete_lib

Current value = true

From //out/first/args.gn:4

Overridden from the default = false

From //pdfium.gni:54

Build a complete static library

pdf_is_standalone

Current value = true

From //out/first/args.gn:3

Overridden from the default = false

From //pdfium.gni:51

Build PDFium standalone

pdf_use_skia

Current value = false

From //out/first/args.gn:7

Overridden from the default = false

From //pdfium.gni:41

Build PDFium against Skia (experimental) rather than AGG. Use Skia to draw

everything.

pdf_use_skia_paths

Current value = false

From //out/first/args.gn:8

Overridden from the default = false

From //pdfium.gni:45

Build PDFium against Skia (experimental) rather than AGG. Use Skia to draw

paths.

pdf_use_win32_gdi

Current value (from the default) = false

From //pdfium.gni:48

Build PDFium with or without experimental win32 GDI APIs.

pgo_data_path

Current value (from the default) = ""

From //build/config/compiler/pgo/pgo.gni:16

When using chrome_pgo_phase = 2, read profile data from this path.

pkg_config

Current value (from the default) = ""

From //build/config/linux/pkg_config.gni:33

A pkg-config wrapper to call instead of trying to find and call the right

pkg-config directly. Wrappers like this are common in cross-compilation

environments.

Leaving it blank defaults to searching PATH for 'pkg-config' and relying on

the sysroot mechanism to find the right .pc files.

proprietary_codecs

Current value (from the default) = false

From //build/config/features.gni:26

Enables proprietary codecs and demuxers; e.g. H264, AAC, MP3, and MP4.

We always build Google Chrome and Chromecast with proprietary codecs.

Note: this flag is used by WebRTC which is DEPSed into Chrome. Moving it

out of //build will require using the build_overrides directory.

ro_segment_workaround_for_valgrind

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:122

Set to true to pass --no-rosegment to lld. This is a workaround

for a KI issue in Valgrind,

https://bugs.kde.org/show_bug.cgi?id=384727

sample_profile_is_accurate

Current value (from the default) = false

From //build/config/compiler/compiler.gni:114

Whether we should consider the profile we're using to be accurate. Accurate

profiles have the benefit of (potentially substantial) binary size

reductions, by instructing the compiler to optimize cold and uncovered

functions heavily for size. This often comes at the cost of performance.

sanitizer_coverage_flags

Current value (from the default) = ""

From //build/config/sanitizers/sanitizers.gni:106

Value for -fsanitize-coverage flag. Setting this causes

use_sanitizer_coverage to be enabled.

This flag is not used for libFuzzer (use_libfuzzer=true). Instead, we use:

-fsanitize=fuzzer-no-link

Default value when unset and use_fuzzing_engine=true:

trace-pc-guard

Default value when unset and use_sanitizer_coverage=true:

trace-pc-guard,indirect-calls

strip_absolute_paths_from_debug_symbols

Current value (from the default) = true

From //build/config/compiler/compiler.gni:213

strip_debug_info

Current value (from the default) = false

From //build/config/compiler/compiler.gni:44

Android-only: Strip the debug info of libraries within lib.unstripped to

reduce size. As long as symbol_level > 0, this will still allow stacks to be

symbolized.

symbol_level

Current value (from the default) = -1

From //build/config/compiler/compiler.gni:39

How many symbols to include in the build. This affects the performance of

the build since the symbols are large and dealing with them is slow.

2 means regular build with symbols.

1 means minimal symbols, usually enough for backtraces only. Symbols with

internal linkage (static functions or those in anonymous namespaces) may not

appear when using this level.

0 means no symbols.

-1 means auto-set according to debug/release and platform.

system_libdir

Current value (from the default) = "lib"

From //build/config/linux/pkg_config.gni:47

CrOS systemroots place pkgconfig files at <systemroot>/usr/share/pkgconfig

and one of <systemroot>/usr/lib/pkgconfig or <systemroot>/usr/lib64/pkgconfig

depending on whether the systemroot is for a 32 or 64 bit architecture.

When build under GYP, CrOS board builds specify the 'system_libdir' variable

as part of the GYP_DEFINES provided by the CrOS emerge build or simple

chrome build scheme. This variable permits controlling this for GN builds

in similar fashion by setting the `system_libdir` variable in the build's

args.gn file to 'lib' or 'lib64' as appropriate for the target architecture.

target_cpu

Current value (from the default) = ""

(Internally set; try `gn help target_cpu`.)

target_os

Current value (from the default) = ""

(Internally set; try `gn help target_os`.)

target_rpath

Current value (from the default) = ""

From //build/config/chromecast_build.gni:27

If non empty, rpath of executables is set to this.

If empty, default value is used.

target_sysroot

Current value (from the default) = ""

From //build/config/sysroot.gni:13

The absolute path of the sysroot that is applied when compiling using

the target toolchain.

target_sysroot_dir

Current value (from the default) = "//build/linux"

From //build/config/sysroot.gni:16

The absolute path to directory containing linux sysroot images

thin_lto_enable_optimizations

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:136

toolkit_views

Current value (from the default) = true

From //build/config/ui.gni:35

True means the UI is built using the "views" framework.

treat_warnings_as_errors

Current value (from the default) = true

From //build/config/compiler/BUILD.gn:49

Default to warnings as errors for default workflow, where we catch

warnings with known toolchains. Allow overriding this e.g. for Chromium

builds on Linux that could use a different version of the compiler.

With GCC, warnings in no-Chromium code are always not treated as errors.

use_afl

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:84

Compile for fuzzing with AFL.

use_aura

Current value (from the default) = true

From //build/config/ui.gni:30

Indicates if Aura is enabled. Aura is a low-level windowing library, sort

of a replacement for GDI or GTK.

use_cfi_cast

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:64

Enable checks for bad casts: derived cast and unrelated cast.

TODO(krasin): remove this, when we're ready to add these checks by default.

https://crbug.com/626794

use_cfi_diag

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:73

Print detailed diagnostics when Control Flow Integrity detects a violation.

use_cfi_icall

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:69

Enable checks for indirect function calls via a function pointer.

TODO(pcc): remove this when we're ready to add these checks by default.

https://crbug.com/701919

use_cfi_recover

Current value (from the default) = false

From //build/config/sanitizers/sanitizers.gni:77

Let Control Flow Integrity continue execution instead of crashing when

printing diagnostics (use_cfi_diag = true).

use_clang_coverage

Current value (from the default) = false

From //build/config/coverage/coverage.gni:17

Enable Clang's Source-based Code Coverage.

use_custom_libcxx

Current value = false

From //out/first/args.gn:15

Overridden from the default = true

From //build/config/c++/c++.gni:14

use_custom_libcxx_for_host

Current value (from the default) = false

From //build/config/c++/c++.gni:25

Use libc++ instead of stdlibc++ when using the host_cpu toolchain, even if

use_custom_libcxx is false. This is useful for cross-compiles where a custom

toolchain for the target_cpu has been set as the default toolchain, but

use_custom_libcxx should still be true when building for the host. The

expected usage is to set use_custom_libcxx=false and

use_custom_libcxx_for_host=true in the passed in buildargs.

use_cxx11

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:92

Allow projects that wish to stay on C++11 to override Chromium's default.

use_cxx11_on_android

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:150

C++11 may not be an option if Android test infrastructure is used.

use_dbus

Current value (from the default) = true

From //build/config/features.gni:31

use_debug_fission

Current value (from the default) = "default"

From //build/config/compiler/compiler.gni:60

use_debug_fission: whether to use split DWARF debug info

files. This can reduce link time significantly, but is incompatible

with some utilities such as icecc and ccache. Requires gold and

gcc >= 4.8 or clang.

http://gcc.gnu.org/wiki/DebugFission

This is a placeholder value indicating that the code below should set

the default. This is necessary to delay the evaluation of the default

value expression until after its input values such as use_gold have

been set, e.g. by a toolchain_args() block.

use_ghash

Current value (from the default) = true

From //build/config/compiler/BUILD.gn:126

Turn this on to use ghash feature of lld for faster debug link on Windows.

http://blog.llvm.org/2018/01/improving-link-time-on-windows-with.html

use_gio

Current value (from the default) = true

From //build/config/features.gni:33

use_glib

Current value (from the default) = true

From //build/config/ui.gni:39

Whether we should use glib, a low level C utility library.

use_gold

Current value (from the default) = true

From //build/config/compiler/compiler.gni:195

use_goma

Current value = false

From //out/first/args.gn:14

Overridden from the default = false

From //build/toolchain/goma.gni:9

Set to true to enable distributed compilation using Goma.

use_icf

Current value (from the default) = false

From //build/config/compiler/BUILD.gn:166

Set to true to use icf, Identical Code Folding.

icf=all is broken in older golds, see

https://sourceware.org/bugzilla/show_bug.cgi?id=17704

6. 전체 빌드하기

out/first/build.ninja 파일을 보면 다음의 빌드 옵션이 있다는 것을 알 수 있다.

build freetype_common: phony obj/freetype_common.stamp

build fuzzers: phony obj/fuzzers.stamp

build pdfium: phony obj/libpdfium.a

build pdfium_all: phony obj/pdfium_all.stamp

build pdfium_embeddertest_deps: phony obj/pdfium_embeddertest_deps.stamp

build pdfium_public_headers: phony obj/pdfium_public_headers.stamp

build pdfium_public_headers_impl: phony obj/pdfium_public_headers_impl.stamp

build pdfium_unittest_deps: phony obj/pdfium_unittest_deps.stamp

build samples: phony obj/samples.stamp

build constants: phony obj/constants/constants.stamp

build fpdfsdk: phony obj/fpdfsdk/fpdfsdk.stamp

build fxjs: phony obj/fxjs/fxjs.stamp

build third_party: phony obj/third_party/third_party.stamp

build cmaps: phony obj/core/fpdfapi/cmaps/cmaps.stamp

...

ninja pdfium 은 pdfium 라이브러리만 빌드한다. unit test 를 포함한 전체 빌드는 다음과 같이 한다.

$ cd out/first

$ ninja pdfium_all

FAILED: obj/testing/test_support/file_util.o

...

../../testing/utils/file_util.cpp: In member function ‘int FileAccessForTesting::GetBlockImpl(long unsigned int, unsigned char*, long unsigned int)’:

../../testing/utils/file_util.cpp:56:3: error: ‘memcpy’ was not declared in this scope

memcpy(pBuf, file_contents_.get() + pos, size);

^~~~~~

../../testing/utils/file_util.cpp:56:3: note: ‘memcpy’ is defined in header ‘<cstring>’; did you forget to ‘#include <cstring>’?

../../testing/utils/file_util.cpp:10:1:

+#include <cstring>

../../testing/utils/file_util.cpp:56:3:

memcpy(pBuf, file_contents_.get() + pos, size);

^~~~~~

[142/222] CXX obj/fpdfsdk/embeddertests/fpdf_edit_embeddertest.o

ninja: build stopped: subcommand failed.

../../testing/utils/file_util.cpp 파일에 <cstring> 헤더를 추가해 준다.

빌드하면, pdfium_embeddertests 및 pdfium_test, pdfium_unittests 등의 파일이 생성된다.

테스트를 실행한다.

$ ./pdfium_embeddertests

...

[ PASSED ] 449 tests.

[ FAILED ] 31 tests, listed below:

[ FAILED ] CPDFSecurityHandlerEmbedderTest.PasswordAfterGenerateSave

[ FAILED ] FPDFParserDecodeEmbedderTest.Bug_455199

[ FAILED ] FPDFProgressiveRenderEmbedderTest.RenderWithoutPause

[ FAILED ] FPDFProgressiveRenderEmbedderTest.RenderWithPause

[ FAILED ] FPDFProgressiveRenderEmbedderTest.RenderAnnotWithPause

[ FAILED ] FPDFProgressiveRenderEmbedderTest.RenderFormsWithPause

[ FAILED ] FPDFAnnotEmbedderTest.ExtractInkMultiple

[ FAILED ] FPDFAnnotEmbedderTest.AddAndSaveUnderlineAnnotation

[ FAILED ] FPDFAnnotEmbedderTest.ModifyRectQuadpointsWithAP

[ FAILED ] FPDFAnnotEmbedderTest.AddAndModifyPath

[ FAILED ] FPDFAnnotEmbedderTest.AddAndModifyImage

[ FAILED ] FPDFAnnotEmbedderTest.AddAndModifyText

[ FAILED ] FPDFAnnotEmbedderTest.GetSetStringValue

[ FAILED ] FPDFEditEmbedderTest.SetText

[ FAILED ] FPDFEditEmbedderTest.RemovePageObject

[ FAILED ] FPDFEditEmbedderTest.RemoveMarkedObjectsPrime

[ FAILED ] FPDFEditEmbedderTest.RemoveExistingPageObjectSplitStreamsNotLonely

[ FAILED ] FPDFEditEmbedderTest.RemoveExistingPageObjectSplitStreamsLonely

[ FAILED ] FPDFEditEmbedderTest.RemoveAllFromStream

[ FAILED ] FPDFEditEmbedderTest.RemoveFirstFromSingleStream

[ FAILED ] FPDFEditEmbedderTest.RemoveLastFromSingleStream

[ FAILED ] FPDFEditEmbedderTest.PathOnTopOfText

[ FAILED ] FPDFEditEmbedderTest.AddStandardFontText

[ FAILED ] FPDFEditEmbedderTest.AddStandardFontText2

[ FAILED ] FPDFEditEmbedderTest.AddTrueTypeFontText

[ FAILED ] FPDFEditEmbedderTest.AddCIDFontText

[ FAILED ] FPDFEditEmbedderTest.AddMarkCompressedStream

[ FAILED ] FPDFEditEmbedderTest.AddMarkedText

[ FAILED ] FPDFFlattenEmbedderTest.BUG_861842

[ FAILED ] FPDFFormFillEmbedderTest.FormText

[ FAILED ] FPDFViewEmbedderTest.RenderHelloWorldWithFlags

$ ./pdfium_unittests

...

[----------] Global test environment tear-down

[==========] 637 tests from 84 test suites ran. (516 ms total)

[ PASSED ] 637 tests.

YOU HAVE 3 DISABLED TESTS

임베드 테스트의 경우, 많은 테스트 오류가 발생한다.

시스템 라이브러리를 사용하도록 한 옵션들중 freetype 은 임베드된 소스를 사용하도록 다시 수정한다.

# Build arguments go here.

# See "gn args <out_dir> --list" for available build arguments.

pdf_is_standalone = true # Set for a non-embedded build.

pdf_is_complete_lib = true # Static Library - libpdfium.a

pdf_enable_xfa = false # XFA support enabled.

pdf_enable_v8 = false # Javascript support enabled.

pdf_use_skia = false # Avoid skia backend experiment.

pdf_use_skia_paths = false # Avoid other skia backend experiment.

pdf_bundle_freetype = true

use_system_freetype = false

clang_use_chrome_plugins = false

use_goma = false

use_custom_libcxx = false

use_sysroot = false

is_component_build = false # Dynamic Library - libpdfium.so

is_debug = false # Enable debugging features.

is_clang = false # Avoid dependency hell.

use_system_zlib = true

use_system_libpng = true

use_system_lcms2 = true

use_system_libjpeg = true

use_libjpeg_turbo = true

use_system_libopenjpeg2 = true

테스트를 다시 실행한다.

$ ./pdfium_embeddertests

...

../../fpdfsdk/fpdf_edit_embeddertest.cpp:2660: Failure

Expected equality of these values:

"IPAGothic"

Which is: 0x55dfe376de88

CIDfont.GetFaceName()

Which is: { 'A' (65, 0x41), 'R' (82, 0x52), ' ' (32, 0x20), 'P' (80, 0x50), 'L' (76, 0x4C), ' ' (32, 0x20), 'U' (85, 0x55), 'K' (75, 0x4B), 'a' (97, 0x61), 'i' (105, 0x69), ' ' (32, 0x20), 'C' (67, 0x43), 'N' (78, 0x4E), ' ' (32, 0x20), 'B' (66, 0x42), 'o' (111, 0x6F), 'o' (111, 0x6F), 'k' (107, 0x6B) }

../../testing/embedder_test.cpp:640: Failure

Expected equality of these values:

expected_md5sum

Which is: "5159a72903fe57bf0cf645c894de8a74"

HashBitmap(bitmap)

Which is: "b60a1543387b3dec1401459836241844"

../../testing/embedder_test.cpp:640: Failure

Expected equality of these values:

expected_md5sum

Which is: "5159a72903fe57bf0cf645c894de8a74"

HashBitmap(bitmap)

Which is: "b60a1543387b3dec1401459836241844"

[ FAILED ] FPDFEditEmbedderTest.AddCIDFontText (1017 ms)

...

[----------] Global test environment tear-down

[==========] 480 tests from 36 test suites ran. (4441 ms total)

[ PASSED ] 479 tests.

[ FAILED ] 1 test, listed below:

[ FAILED ] FPDFEditEmbedderTest.AddCIDFontText

단, 1개의 테스트 오류만 발생했다.

일단, system freetype 사용은 끄도록 하고 1개의 테스트 오류는 무시한다.

저작자표시