Home | History | Annotate | only in /external/chromium_org/native_client_sdk/src
Up to higher level directory
NameDateSize
.gitignore16-Dec-2014653
AUTHORS10-Mar-2015320
build_tools/10-Mar-2015
BUILDING.rst10-Mar-20153.5K
COPYING16-Dec-20141.4K
doc/10-Mar-2015
examples/16-Dec-2014
getting_started/16-Dec-2014
gonacl_appengine/16-Dec-2014
libraries/16-Dec-2014
LICENSE16-Dec-20141.4K
README10-Mar-2015713
README.Makefiles16-Dec-20143.2K
README.naclports16-Dec-2014498
resources/10-Mar-2015
test_all.py10-Mar-20152.2K
tests/16-Dec-2014
tools/10-Mar-2015
web/16-Dec-2014

README

      1 Welcome to the Native Client SDK
      2 ================================
      3 
      4 Native Client Tools Bundle
      5 Version: ${VERSION}
      6 Chrome Revision: ${CHROME_REVISION}
      7 Chrome Commit Position: ${CHROME_COMMIT_POSITION}
      8 Native Client Revision: ${NACL_REVISION}
      9 Build Date: ${DATE}
     10 
     11 Please refer to the online documentation here:
     12 
     13   https://developer.chrome.com/native-client
     14 
     15 Contributing
     16 ------------
     17 
     18 If you want to contribute to the Native Client SDK itself, please read the
     19 online documentation on contributing code to Chromium here:
     20 
     21   http://www.chromium.org/developers/contributing-code
     22 
     23 Known Issues
     24 ------------
     25 
     26 Please refer to the online documentation here:
     27 
     28   https://developer.chrome.com/native-client/sdk/release-notes
     29

README.Makefiles

      1 Build System for Native Client SDK examples
      2 ===========================================
      3 
      4 The examples and libraries that ship with the Native Client SDK use a
      5 build system based on GNU Make.
      6 
      7 Each example or library is contained in its own directory along with a
      8 Makefile. The Makefiles are capable of building Native Client
      9 applications and libraries using any of the available toolchains as well
     10 as building host applications with the host's toolchain. In order to
     11 keep the top-level Makefiles simple, most of actual build rules are
     12 specified in as set of shared rules files in the $NACL_SDK_ROOT/tools
     13 directory.
     14 
     15 This document describes some of the variables and macros used by in the
     16 build system.  For more details please see the .mk files in the tools
     17 folder.
     18 
     19 Using the build system for new projects
     20 --------------------------------------
     21 
     22 It is perfectly possible to use the included build system for projects
     23 outside of the Native Client SDK.  A good starting point for doing this
     24 would be to copy the Makefile from the hello_world example.  In most
     25 simple cases the only changes needed are to update the SOURCES and
     26 TARGET variables.
     27 
     28 User Variables
     29 --------------
     30 
     31 TARGET
     32   This variable holds the name of your project.  Normally this is the
     33   basename of the library or executable which is the final target.
     34 
     35 SOURCES
     36   The list of sources to be built.  In most cases this list is passed to
     37   the compile and link macros.
     38 
     39 VALID_TOOLCHAINS
     40   This variable can be used to control which toolchains are supported by
     41   the project.  Valid entries for this list are: newlib, glibc, pnacl,
     42   linux, mac, win.  The default value is: "newlib glibc pnacl".
     43 
     44 NACL_SDK_ROOT
     45   Optionally force the build system to use a certain location for the
     46   Native Client SDK. If not set within the Makefile the $NACL_SDK_ROOT
     47   environment variable will by used. It is an error if this variable is
     48   neither set within the Makefile nor in the environment.
     49 
     50 Macros / Rules
     51 --------------
     52 
     53 The following macros can be used in the Makefiles to generate the rules
     54 for building the various kinds types of target.  These are designed to
     55 be used via the 'call' macro.  e.g.  $(call COMPILE_RULE,$(SOURCES))
     56 
     57 COMPILE_RULE
     58   This rule is used to build object files from a list of sources.
     59 
     60 SO_RULE
     61   Used to build shared objects from a list of sources.
     62 
     63 LIB_RULE
     64   Used to build static libraries from a list of sources.
     65 
     66 NMF_RULE
     67   Used to build nmf metadata file from a native client executable (or
     68   set of executables). This is needed in order to run the executable in
     69   chrome.
     70 
     71 HTML_RULE
     72   Used to build both html and nmf files from a native client executable
     73   (or set of executables) which will allow the executable to be run
     74   in chrome.
     75 
     76 For more information on how to use these rules in your Makefile see
     77 the shared Makefiles in the tools folders:
     78 
     79 common.mk
     80   Top level shared rules file that include the toolchain specific
     81   rules.
     82 
     83 nacl_gcc.mk
     84   Rules for building using the gcc-based NaCl toolchains.
     85 
     86 nacl_llvm.mk
     87   Rules for building using the llvm-based PNaCl toolchains.
     88 
     89 host_gcc.mk
     90   Rules for building using the linux/mac host gcc toolchain.
     91 
     92 host_vc.mk
     93   Rules for building using the windows Visual Studio toolchain.
     94 
     95 .. vim: ft=rst tw=72
     96

README.naclports

      1 NaCl Ports
      2 ==========
      3 
      4 This folder contains headers and pre-built libraries for several
      5 of the more commonly used open source third-party libraries.
      6 
      7 These libraries were built from the naclports project.  For access
      8 to the full sources, or to rebuild or modify these libraries please
      9 follow the instructions on naclports:
     10 
     11   https://code.google.com/p/naclports/
     12 
     13 Please note that each of libraries libraries is licensed under its
     14 own specific license.   See NOTICE for full list of license terms.
     15