Add comments in DSC files to explain the function and design of components section.
[mirror/efi/fat/.git] / FatPkg / FatPkg.dsc
1 #/** @file\r
2 #\r
3 #  Build Binary Enhanced Fat Driver Modules\r
4 #\r
5 #  This Platform file is used to generate the Binary Fat Drivers\r
6 #  for EDK II Prime release.\r
7 #  Copyright (c) 2007, Intel Corporation\r
8 #\r
9 #  Redistribution and use in source and binary forms, with or without\r
10 #  modification, are permitted provided that the following conditions are\r
11 #  met:\r
12 #\r
13 #   Redistributions of source code must retain the above copyright\r
14 #   notice, this list of conditions and the following disclaimer.\r
15 #\r
16 #   Redistributions in binary form must reproduce the above copyright\r
17 #   notice, this list of conditions and the following disclaimer in\r
18 #   the documentation and/or other materials provided with the\r
19 #   distribution.\r
20 #\r
21 #   Neither the name of Intel nor the names of its contributors may\r
22 #   be used to endorse or promote products derived from this software\r
23 #   without specific prior written permission.\r
24 #\r
25 #  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\r
26 #  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\r
27 #  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR\r
28 #  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT\r
29 #  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,\r
30 #  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
31 #  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\r
32 #  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\r
33 #  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
34 #  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\r
35 #  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
36 #\r
37 #  Additional terms: In addition to the forgoing, redistribution and use\r
38 #  of the code is conditioned upon the FAT 32 File System Driver and all\r
39 #  derivative works thereof being used for and designed only to read\r
40 #  and/or write to a file system that is directly managed by an\r
41 #  Extensible Firmware Interface (EFI) implementation or by an emulator\r
42 #  of an EFI implementation.\r
43 #\r
44 #**/\r
45 \r
46 [Defines]\r
47   PLATFORM_NAME                  = Fat\r
48   PLATFORM_GUID                  = 25b55dbc-9d0b-4a32-80da-46e1273d622c\r
49   PLATFORM_VERSION               = 0.1\r
50   DSC_SPECIFICATION              = 0x00010005\r
51   SUPPORTED_ARCHITECTURES        = IA32|X64|IPF|EBC\r
52   OUTPUT_DIRECTORY               = Build/Fat\r
53   BUILD_TARGETS                  = DEBUG|RELEASE\r
54   SKUID_IDENTIFIER               = DEFAULT\r
55 \r
56 [LibraryClasses.common]\r
57   #\r
58   # Entry Point Libraries\r
59   #\r
60   UefiDriverEntryPoint|MdePkg/Library/UefiDriverEntryPoint/UefiDriverEntryPoint.inf\r
61   #\r
62   # Common Libraries\r
63   #\r
64   BaseLib|MdePkg/Library/BaseLib/BaseLib.inf\r
65   BaseMemoryLib|MdePkg/Library/BaseMemoryLib/BaseMemoryLib.inf\r
66   UefiLib|MdePkg/Library/UefiLib/UefiLib.inf\r
67   PrintLib|MdePkg/Library/BasePrintLib/BasePrintLib.inf\r
68   PcdLib|MdePkg/Library/DxePcdLib/DxePcdLib.inf\r
69   MemoryAllocationLib|MdePkg/Library/UefiMemoryAllocationLib/UefiMemoryAllocationLib.inf\r
70   UefiBootServicesTableLib|MdePkg/Library/UefiBootServicesTableLib/UefiBootServicesTableLib.inf\r
71   UefiRuntimeServicesTableLib|MdePkg/Library/UefiRuntimeServicesTableLib/UefiRuntimeServicesTableLib.inf\r
72   DebugLib|MdePkg/Library/BaseDebugLibNull/BaseDebugLibNull.inf\r
73   DevicePathLib|MdePkg/Library/UefiDevicePathLib/UefiDevicePathLib.inf\r
74 \r
75 ###################################################################################################\r
76 #\r
77 # Components Section - list of the modules and components that will be processed by compilation\r
78 #                      tools and the EDK II tools to generate PE32/PE32+/Coff image files.\r
79 #\r
80 # Note: The EDK II DSC file is not used to specify how compiled binary images get placed\r
81 #       into firmware volume images. This section is just a list of modules to compile from\r
82 #       source into UEFI-compliant binaries.\r
83 #       It is the FDF file that contains information on combining binary files into firmware\r
84 #       volume images, whose concept is beyond UEFI and is described in PI specification.\r
85 #       Binary modules do not need to be listed in this section, as they should be\r
86 #       specified in the FDF file. For example: Shell binary (Shell_Full.efi), FAT binary (Fat.efi),\r
87 #       Logo (Logo.bmp), and etc.\r
88 #       There may also be modules listed in this section that are not required in the FDF file,\r
89 #       When a module listed here is excluded from FDF file, then UEFI-compliant binary will be\r
90 #       generated for it, but the binary will not be put into any firmware volume.\r
91 #\r
92 ###################################################################################################\r
93 \r
94 [Components.common]\r
95   FatPkg/EnhancedFatDxe/Fat.inf\r