blob: ae17f47cd4e67d4d94453ba5250969ef8febe11d [file] [log] [blame]
/*
* Copyright 2020 The Pigweed Authors
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
/*
*
* This linker script snippet declares the sections needed for string
* tokenization. All sections have type INFO so they are excluded from the final
* binary.
*
* The contents of this script can be copied into an existing linker script.
* Alternately, this file can be directly included in a linker script with an
* include directive. For example,
*
* INCLUDE path/to/modules/pw_tokenizer/pw_tokenizer_linker_sections.ld
*
* SECTIONS
* {
* (your existing linker sections)
* }
*/
SECTIONS
{
/*
* This section stores metadata that may be used during tokenized string
* decoding. This metadata describes properties that may affect how the
* tokenized string is encoded or decoded -- the maximum length of the hash
* function and the sizes of certain integer types.
*
* Metadata is declared as key-value pairs. See the metadata variable in
* tokenize.cc for further details.
*/
.pw_tokenizer.info 0x0 (INFO) :
{
KEEP(*(.pw_tokenizer.info))
}
/*
* Tokenized string entries are stored in this section. Each entry contains
* the original string literal and the calculated token that represents it. In
* the compiled code, the token and a compact argument list encoded in a
* uint32_t are used in place of the format string. The compiled code
* contains no references to the tokenized string entries in this section.
*
* The tokenized string entry format is specified by the
* pw::tokenizer::internal::Entry class in
* pw_tokenizer/public/pw_tokenizer/internal/tokenize_string.h.
*
* The section contents are declared with KEEP so that they are not removed
* from the ELF. These are never emitted in the final binary or loaded into
* memory.
*/
.pw_tokenizer.entries 0x0 (INFO) :
{
KEEP(*(.pw_tokenizer.entries.*))
}
}