| #ifndef CONFIG_BRANDING_H |
| #define CONFIG_BRANDING_H |
| |
| /** @file |
| * |
| * Branding configuration |
| * |
| */ |
| |
| FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL ); |
| |
| #include <config/defaults.h> |
| |
| /* |
| * Branding |
| * |
| * Vendors may use these strings to add their own branding to iPXE. |
| * PRODUCT_NAME is displayed prior to any iPXE branding in startup |
| * messages, and PRODUCT_SHORT_NAME is used where a brief product |
| * label is required (e.g. in BIOS boot selection menus). |
| * |
| * To minimise end-user confusion, it's probably a good idea to either |
| * make PRODUCT_SHORT_NAME a substring of PRODUCT_NAME or leave it as |
| * "iPXE". |
| * |
| */ |
| #define PRODUCT_NAME "" |
| #define PRODUCT_SHORT_NAME "iPXE" |
| #define PRODUCT_URI "https://ipxe.org" |
| |
| /* |
| * Tag line |
| * |
| * If your PRODUCT_SHORT_NAME is longer than the four characters used |
| * by "iPXE", then the standard tag line "Open Source Network Boot |
| * Firmware" is unlikely to fit neatly onto the screen. |
| */ |
| #define PRODUCT_TAG_LINE "Open Source Network Boot Firmware" |
| |
| /* |
| * Error messages |
| * |
| * iPXE error messages comprise a summary error message |
| * (e.g. "Permission denied") and a 32-bit error number. This number |
| * is incorporated into an error URI such as |
| * |
| * "No such file or directory (https://ipxe.org/2d0c613b)" |
| * |
| * or |
| * |
| * "Operation not supported (https://ipxe.org/3c092003)" |
| * |
| * Users may browse to the URI within the error message, which is |
| * provided by a database running on the iPXE web site |
| * (https://ipxe.org). This database provides details for all possible |
| * errors generated by iPXE, including: |
| * |
| * - the detailed error message (e.g. "Not an OCSP signing |
| * certificate") to complement the summary message (e.g. "Permission |
| * denied") which is compiled into the iPXE binary. |
| * |
| * - an instruction to the user to upgrade, if the error cannot be |
| * generated by the latest version of iPXE. |
| * |
| * - hints on how to fix the error (e.g. "This error indicates that |
| * the file was not found on the TFTP server. Check that you can |
| * retrieve the file using an alternative TFTP client, such as |
| * tftp-hpa on Linux.") |
| * |
| * - details of which source file within the iPXE codebase generated |
| * the error. |
| * |
| * - a direct link to the line(s) of code which generated the error. |
| * |
| * If you have a customer support team and would like your customers |
| * to contact your support team for all problems, instead of using the |
| * existing support infrastructure provided by https://ipxe.org, then |
| * you may define a custom URI to be included within error messages. |
| * |
| * Note that the custom URI is a printf() format string which must |
| * include a format specifier for the 32-bit error number. |
| */ |
| #define PRODUCT_ERROR_URI "https://ipxe.org/%08x" |
| |
| /* |
| * Command help messages |
| * |
| * iPXE command help messages include a URI constructed from the |
| * command name, such as |
| * |
| * "See https://ipxe.org/cmd/vcreate for further information" |
| * |
| * The iPXE web site includes documentation for the commands provided |
| * by the iPXE shell, including: |
| * |
| * - details of the command syntax (e.g. "vcreate --tag <tag> |
| * [--priority <priority>] <trunk interface>"). |
| * |
| * - example usages of the command (e.g. "vcreate --tag 123 net0") |
| * |
| * - a formal description of the command (e.g. "Create a VLAN network |
| * interface on an existing trunk network interface. The new network |
| * interface will be named by appending a hyphen and the VLAN tag |
| * value to the trunk network interface name.") |
| * |
| * - details of the possible exit statuses from the command. |
| * |
| * - links to documentation for related commands (e.g. "vdestroy") |
| * |
| * - links to documentation for relevant build options (e.g. "VLAN_CMD"). |
| * |
| * - general hints and tips on using the command. |
| * |
| * If you want to provide your own documentation for all of the |
| * commands provided by the iPXE shell, rather than using the existing |
| * support infrastructure provided by https://ipxe.org, then you may |
| * define a custom URI to be included within command help messages. |
| * |
| * Note that the custom URI is a printf() format string which must |
| * include a format specifier for the command name. |
| * |
| * [ Please also note that the existing documentation is licensed |
| * under Creative Commons terms which require attribution to the |
| * iPXE project and prohibit the alteration or removal of any |
| * references to "iPXE". ] |
| */ |
| #define PRODUCT_COMMAND_URI "https://ipxe.org/cmd/%s" |
| |
| /* |
| * Setting help messages |
| * |
| * iPXE setting help messages include a URI constructed from the |
| * setting name, such as |
| * |
| * "https://ipxe.org/cfg/initiator-iqn" |
| * |
| * The iPXE web site includes documentation for the settings used by |
| * iPXE, including: |
| * |
| * - details of the corresponding DHCP option number. |
| * |
| * - details of the corresponding ISC dhcpd option name. |
| * |
| * - examples of using the setting from the iPXE command line, or in |
| * iPXE scripts. |
| * |
| * - examples of configuring the setting via a DHCP server. |
| * |
| * - a formal description of the setting. |
| * |
| * - links to documentation for related settings. |
| * |
| * - links to documentation for relevant build options. |
| * |
| * - general notes about the setting. |
| * |
| * If you want to provide your own documentation for all of the |
| * settings used by iPXE, rather than using the existing support |
| * infrastructure provided by https://ipxe.org, then you may define a |
| * custom URI to be included within setting help messages. |
| * |
| * Note that the custom URI is a printf() format string which must |
| * include a format specifier for the setting name. |
| * |
| * [ Please also note that the existing documentation is licensed |
| * under Creative Commons terms which require attribution to the |
| * iPXE project and prohibit the alteration or removal of any |
| * references to "iPXE". ] |
| */ |
| #define PRODUCT_SETTING_URI "https://ipxe.org/cfg/%s" |
| |
| /* |
| * Product security name suffix |
| * |
| * Vendors creating signed iPXE binaries must set this to a non-empty |
| * value (e.g. "2pint"). |
| */ |
| #define PRODUCT_SBAT_NAME "" |
| |
| /* |
| * Product security generation |
| * |
| * Vendors creating signed iPXE binaries must set this to a non-zero |
| * value, and must increment the value whenever a Secure Boot exploit |
| * is fixed (unless the upstream IPXE_SBAT_GENERATION has already been |
| * incremented as part of that fix). |
| */ |
| #define PRODUCT_SBAT_GENERATION 0 |
| |
| #include <config/local/branding.h> |
| |
| #endif /* CONFIG_BRANDING_H */ |