Yocto-Project-Development-Manual

[e-mail]©2010-2015LinuxFoundationPermissionisgrantedtocopy,distributeand/ormodifythisdocumentunderthetermsoftheCreativeCommonsAttribution-ShareAlike2.0UK:England&WalesaspublishedbyCreativeCommons.NoteForthelatestversionofthismanualassociatedwiththisYoctoProjectrelease,seetheYoctoProjectDevelopmentManualfromtheYoctoProjectwebsite.RevisionHistoryRevision1.16October2011TheinitialdocumentreleasedwiththeYoctoProject1.1Release.Revision1.2April2012ReleasedwiththeYoctoProject1.2Release.Revision1.3October2012ReleasedwiththeYoctoProject1.3Release.Revision1.4April2013ReleasedwiththeYoctoProject1.4Release.Revision1.5October2013ReleasedwiththeYoctoProject1.5Release.Revision1.5.1January2014ReleasedwiththeYoctoProject1.5.1Release.Revision1.6April2014ReleasedwiththeYoctoProject1.6Release.Revision1.7October2014ReleasedwiththeYoctoProject1.7Release.Revision1.8April2015ReleasedwiththeYoctoProject1.8Release.Revision2.0October2015ReleasedwiththeYoctoProject2.0Release.TableofContents1.TheYoctoProjectDevelopmentManual1.1.Introduction1.2.WhatThisManualProvides1.3.WhatthisManualDoesNotProvide15-11-30YoctoProjectDevelopmentManual(SCM)3.2.3.Autobuilders3.2.4.PoliciesandChangeFlow3.2.5.Summary3.3.YoctoProjectSourceRepositories3.4.YoctoProjectTerms3.5.Licensing3.6.Git3.6.1.Repositories,Tags,andBranches3.6.2.BasicCommands3.7.Workflows3.8.TrackingBugs3.9.HowtoSubmitaChange3.9.1.UsingScriptstoPushaChangeUpstreamandRequestaPull3.9.2.UsingEmailtoSubmitaPatch4.CommonDevelopmentModels4.1.SystemDevelopmentWorkflow4.1.1.DevelopingaBoardSupportPackage(BSP)4.1.2.ModifyingtheKernel4.2.ApplicationDevelopmentWorkflow4.2.1.WorkflowUsingtheADTandEclipse™4.2.2.WorkingWithinEclipse4.2.3.WorkflowUsingStand-AloneCross-DevelopmentToolchains4.3.ModifyingSourceCode4.3.1.UsingdevtoolinYourWorkflow4.3.2.devtoolQuickReference4.3.3.UsingQuiltinYourWorkflow4.3.4.FindingTemporarySourceCode4.4.ImageDevelopmentUsingToaster4.5.ImageDevelopmentUsingHob4.6.UsingaDevelopmentShell5.CommonTasks5.1.UnderstandingandCreatingLayers5.1.1.Layers5.1.2.CreatingYourOwnLayer5.1.3.BestPracticestoFollowWhenCreatingLayers5.1.4.EnablingYourLayer5.1.5.Using.bbappendFiles5.1.6.PrioritizingYourLayer5.1.7.ManagingLayers5.1.8.CreatingaGeneralLayerUsingtheyocto-layerScript5.2.CustomizingImages5.2.1.CustomizingImagesUsinglocal.conf5.2.2.CustomizingImagesUsingCustomIMAGE_FEATURESandEXTRA_IMAGE_FEATURES5.2.3.CustomizingImagesUsingCustom.bbFiles5.2.4.CustomizingImagesUsingCustomPackageGroups5.2.5.CustomizinganImageHostname5.3.WritingaNewRecipe5.3.1.Overview5.3.2.LocateorAutomaticallyCreateaBaseRecipe5.3.3.StoringandNamingtheRecipe5.3.4.UnderstandingRecipeSyntax5.3.5.RunningaBuildontheRecipe5.3.6.FetchingCode5.3.7.UnpackingCode5.3.8.PatchingCode5.3.9.Licensing5.3.10.ConfiguringtheRecipe5.3.11.Compilation5.3.12.Installing5.3.13.EnablingSystemServices5.3.14.Packaging5.3.15.ProperlyVersioningPre-ReleaseRecipes5.3.16.Post-InstallationScripts5.3.17.Testing5.3.18.Examples5.4.AddingaNewMachine5.4.1.AddingtheMachineConfigurationFile5.4.2.AddingaKernelfortheMachine5.4.3.AddingaFormfactorConfigurationFile15-11-30YoctoProjectDevelopmentManual(.wks)Reference5.7.ConfiguringtheKernel5.7.1.Usingmenuconfig5.7.2.CreatingadefconfigFile5.7.3.CreatingConfigurationFragments5.7.4.Fine-TuningtheKernelConfigurationFile5.8.PatchingtheKernel5.8.1.CreateaLayerforyourChanges5.8.2.FindingtheKernelSourceCode5.8.3.CreatingthePatch5.8.4.SetUpYourLayerfortheBuild5.8.5.SetUpfortheBuild5.8.6.BuildtheModifiedQEMUKernelImage5.8.7.BoottheImageandVerifyYourChanges5.9.MakingImagesMoreSecure5.9.1.GeneralConsiderations5.9.2.SecurityFlags5.9.3.ConsiderationsSpecifictotheOpenEmbeddedBuildSystem5.9.4.ToolsforHardeningYourImage5.10.CreatingYourOwnDistribution5.11.CreatingaCustomTemplateConfigurationDirectory5.12.BuildingaTinySystem5.12.1.Overview5.12.2.GoalsandGuidingPrinciples5.12.3.UnderstandWhatContributestoYourImageSize5.12.4.TrimtheRootFilesystem5.12.5.TrimtheKernel5.12.6.RemovePackageManagementRequirements5.12.7.LookforOtherWaystoMinimizeSize5.12.8.IterateontheProcess5.13.BuildingImagesforMor