.NET VMR Feature Band Source Building Guide for Linux Distro Maintainers

This document provides guidance for Linux distribution maintainers on source building .NET SDK feature band branches of the Virtual Monolithic Repository (VMR). It covers bootstrapping and ongoing servicing workflows when building multiple SDK feature bands.

What are .NET SDK Feature Bands?
Key Terminology
Overview
Understanding Bootstrap vs Sequential Build
Required Build Inputs
Feature Band Characteristics
Build Requirements by Feature Band
Build Command Arguments
Distro Maintainer Workflows
Troubleshooting
Poison and Prebuilt Detection
Additional Resources

What are .NET SDK Feature Bands?

.NET SDK feature bands are different versions of the .NET SDK that provide additional tooling functionality during the servicing lifetime of a .NET major release. These bands primarily support new Visual Studio scenarios and are identified by differences in the first digit of the patch numbers in the .NET SDK version.

Each feature band shares the same .NET runtime but includes different SDK tooling. For more information, see the official documentation.

Key Terminology

VMR - Virtual Monolithic Repository containing .NET source code
N - Placeholder for the .NET major version number (e.g., N.0.1xx where N=10 for .NET 10)
1xx band - The initial SDK feature band that ships with .NET GA and contains the shared runtime components
2xx/3xx/4xx bands - Additional SDK feature bands with enhanced tooling that are released sequentially (2xx → 3xx → 4xx)
Previously Source-Built (PSB) artifacts - Artifacts from previous builds that provide dependencies but are not redistributed
Shared component artifacts - Shared runtime and foundational components from the 1xx band build that are redistributed across feature bands

Overview

Building .NET SDK feature bands from source follows a two-stage approach:

Build the 1xx band - This produces the shared .NET runtime and the 1xx SDK tooling. The 1xx band contains all runtime components and serves as the foundation for other bands.
Build additional bands (2xx, 3xx, etc.) - These bands contain only the SDK tooling components that differ from the 1xx band. They reuse the shared runtime from the 1xx build.

Each feature band branch in the VMR contains only the source code that differs from the 1xx band. Components that don't change between bands are excluded from the later band branches to avoid confusion and maintenance overhead.

flowchart LR
    subgraph "1xx Band (Full VMR)"
        Runtime[.NET Runtime]
        Core[Core Libraries]
        SDK1xx[1xx SDK Tools]
    end
    
    subgraph "2xx Band (Subset VMR)"
        SDK2xx[2xx SDK Tools]
    end
    
    subgraph "3xx Band (Subset VMR)"
        SDK3xx[3xx SDK Tools]
    end
    
    subgraph "4xx Band (Subset VMR)"
        SDK4xx[4xx SDK Tools]
    end
    
    Runtime -.-> SDK2xx
    Runtime -.-> SDK3xx
    Runtime -.-> SDK4xx
    Core -.-> SDK2xx
    Core -.-> SDK3xx
    Core -.-> SDK4xx
    
    SDK1xx --> SDK2xx
    SDK2xx --> SDK3xx
    SDK3xx --> SDK4xx

Dotted lines indicate shared runtime components from the 1xx band; solid lines show SDK tooling dependencies between bands

Note on 3xx and 4xx bands: The 3xx and 4xx bands follow the same build patterns. To keep the document more concise, the pattern used by 3xx and 4xx will be described in a general way that is come to both bands. When Bxx is used, it refers to the feature band in context (e.g. Bxx means 3xx in the context of the 3xx feature band). Similarly, when (B-1)xx is used, it refers to the previous feature band (e.g. (B-1)xx means 2xx in the context of the 3xx feature band).

Understanding Bootstrap vs Sequential Build

Bootstrap Process (Two-Stage)

Bootstrapping is required when you don't have suitable source-built artifacts to build a release. It's a two-stage process:

Stage 1: Use Microsoft-provided source-built artifacts and Microsoft SDK to build the target release
Stage 2: Use the outputs from Stage 1 to rebuild the same release from source

The second stage validates that the release can be built using only source-built components and produces the final artifacts for distribution.

flowchart TD
    subgraph Bootstrap["Bootstrap (Two-Stage)"]
        MS_SDK[Microsoft SDK] --> Stage1[Stage 1 Build]
        MS_Artifacts[Microsoft Source-Built<br/>Artifacts] --> Stage1
        Stage1 --> SB_SDK[Source-Built SDK]
        Stage1 --> SB_Artifacts[Source-Built Artifacts]
        SB_SDK --> Stage2[Stage 2 Build]
        SB_Artifacts --> Stage2
        Stage2 --> Final1[Final Source-Built SDK]
        Stage2 --> Final2[Final Source-Built<br/>Artifacts]
    end

See Bootstrapping Guidelines for more info.

Sequential Build (Single-Stage)

When you have appropriate source-built artifacts from previous builds, you can build directly without bootstrapping. This is the typical workflow for ongoing releases.

flowchart TD
    subgraph Sequential["Sequential (Single-Stage)"]
        Prev_SDK[Previous Source-Built SDK] --> Build
        Prev_Artifacts[Previous Source-Built<br/>Artifacts] --> Build
        Build --> Final1[Final Source-Built SDK]
        Build --> Final2[Final Source-Built<br/>Artifacts]
    end

Required Build Inputs

When building feature bands, you'll work with two types of source-built artifacts:

Previously Source-Built (PSB) Artifacts

These are artifacts from previous servicing releases or bootstrap builds:

Used as build dependencies but not redistributed in outputs
Come from previous monthly .NET releases (e.g., 8.0.1 artifacts when building 8.0.2)
Subject to poison detection to ensure no Microsoft binaries leak into outputs

Shared Component Artifacts

These are shared runtime and foundational components from the 1xx band:

Come from the 1xx band build in the same release cycle
Can be used as dependencies AND redistributed in outputs
Include shared runtime and foundational components that all feature bands depend on

Feature Band Characteristics

1xx Band (GA/Non-breaking)

The foundational feature band that ships with .NET GA releases:

Content: Contains the complete VMR with .NET runtime, core libraries, and SDK tooling
Purpose: Provides the stable runtime foundation that all other bands depend on
Release cycle: Follows .NET GA release schedule with monthly servicing updates
Compatibility: Non-breaking changes only during servicing
Support: In support for the lifetime of the associated .NET major version

2xx Band

SDK tooling band that ships after the 1xx band:

Content: Contains only tooling sources - runtime/core libraries are excluded
Purpose: Adds enhanced developer tooling features
Release cycle: Independent of other band releases
Dependencies:
- Initial release (N.0.200) depends on the latest 1xx release
- Subsequent releases can depend on previous 2xx releases
- Always uses shared runtime components from 1xx band
Support: In support alongside 1xx until 3xx is released

3xx/4xx Band

Subsequent SDK tooling bands after 2xx band:

Content: Contains only tooling sources - runtime/core libraries are excluded
Purpose: Delivers additional SDK features and capabilities
Release cycle: Independent of other band releases
Dependencies:
- Initial release depends on the latest release of the previous supported feature band
- Subsequent releases can depend on previous releases of the same feature band
- Always uses shared runtime components from 1xx band
Support: In support alongside 1xx
- 3xx becomes unsupported when 4xx is released

Build Requirements by Feature Band

Each feature band has specific requirements for SDKs and artifacts:

1xx Band Build Requirements

Bootstrap (any version): Two-stage process using Microsoft source-built 1xx artifacts + Microsoft SDK + script
Servicing (N.0.101+): Source-built SDK and artifacts from the previous 1xx release

Note: Only the 1xx SDK is guaranteed to build the shared runtime components

2xx Band Build Requirements

Bootstrap (any version): Two-stage process using Microsoft source-built 2xx artifacts + Microsoft 2xx SDK + prep script
Initial Release (N.0.200): Current source-built 1xx artifacts + current source-built 1xx SDK
Servicing (N.0.201+): Source-built SDK and artifacts from the previous 2xx release + current 1xx artifacts

3xx/4xx Band Build Requirements

Bootstrap (any version): Two-stage process using Microsoft source-built Bxx artifacts + Microsoft Bxx SDK + prep script
Initial Release (N.0.B00): Current source-built 1xx artifacts + current source-built (B-1)xx artifacts + current source-built (B-1)xx SDK
Servicing (N.0.B01+): Source-built SDK and artifacts from the previous Bxx release + current 1xx artifacts

Feature Band Key Points

Release schedules across bands are not necessarily aligned (unless there is a security release in the shared components in which case they will be aligned).
1xx band produces the shared runtime that all bands use.
Only 1xx and at most one other band (2xx, 3xx, or 4xx) are in support at any given time.
The initial release of each feature band depends on the latest release of the previous band.
3xx and 4xx bands follow identical build patterns; the scenarios documented for 3xx apply equally to 4xx with adjusted version numbers.

Build Command Arguments

Feature band builds make use of these relevant command-line arguments:

--with-packages - Provides PSB artifacts
--with-shared-components - Provides shared component artifacts from 1xx build
--with-sdk - Specifies the SDK to use for building

Distro Maintainer Workflows

The following sections describe the workflows for different scenarios.

Input Artifacts Summary

For 1xx band builds:

Bootstrap:
- PSB artifacts: Microsoft-built previous N.0.1xx release
- SDK: Microsoft-built previous N.0.1xx release
Servicing:
- PSB artifacts: Source-built previous N.0.1xx release
- SDK: Source-built previous N.0.1xx release

For 2xx band builds:

Initial release (N.0.200):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Source-built previous N.0.1xx release
- SDK: Source-built previous N.0.1xx release
Servicing (N.0.201+):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Source-built previous N.0.2xx release
- SDK: Source-built previous N.0.2xx release
Bootstrap (N.0.200+):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Microsoft-built previous N.0.1xx (for bootstrapping N.0.200) or N.0.2xx (for bootstrapping N0.0.201+) release
- SDK: Microsoft-built previous N.0.1xx release

For 3xx/4xx band builds:

Initial release (N.0.B00):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Source-built previous N.0.(B-1)xx release
- SDK: Source-built previous N.0.(B-1)xx release
Servicing (N.0.B01+):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Source-built previous N.0.Bxx release
- SDK: Source-built previous N.0.Bxx release
Bootstrap (N.0.B00+):
- Shared component artifacts: Source-built current N.0.1xx release
- PSB artifacts: Microsoft-built previous N.0.(B-1)xx release
- SDK: Microsoft-built previous N.0.(B-1)xx release

1xx Band Bootstrap

For the initial bootstrap of a 1xx band (two-stage process):

# Clone VMR branch/tag
git clone -b <1xx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# ===
# Stage 1: Build with Microsoft artifacts
# ===

# Downloads Microsoft source-built 1xx artifacts and Microsoft SDK
./prep-source-build.sh

# Build the SDK
./build.sh --source-only

# Extract and store the built SDK and artifacts
tar -ozxf artifacts/assets/Release/dotnet-sdk-*-tar.gz \
  -C /tmp/dotnet/sdk
tar -ozxf artifacts/assets/Release/Private.SourceBuilt.Artifacts.*.tar.gz \
  -C /tmp/dotnet/artifacts

# ===
# Stage 2: Rebuild using stage 1 outputs
# ===

./build.sh --source-only --with-sdk /tmp/dotnet/sdk --with-packages /tmp/dotnet/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph Msft["Previous 1xx MS Release"]
        MS_SDK[Microsoft-built<br/>1xx SDK]
        MS_Art[Microsoft-built<br/>1xx artifacts]
    end
    
    subgraph SB["Current SB 1xx Release"]
        subgraph Stage1["Stage 1: Bootstrap Build"]
            Build1((Build Process))
            S1_SDK[Stage 1 SDK]
            S1_Art[Stage 1 Artifacts]
        end

        subgraph Stage2["Stage 2: Final Build"]
            Build2((Build Process))
            Final_SDK[Final 1xx SDK]
            Final_Art[Final 1xx Artifacts]
        end
    end
    
    MS_SDK -.->|with-sdk| Build1
    MS_Art -.->|with-packages| Build1
    Build1 --> S1_SDK
    Build1 --> S1_Art
    S1_SDK -.->|with-sdk| Build2
    S1_Art -.->|with-packages| Build2
    Build2 --> Final_SDK
    Build2 --> Final_Art
    
    classDef msRelease fill:#9b9bdb,stroke:#666,stroke-width:2px,color:#000
    classDef prev1xx fill:#db9b9b,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    class Msft msRelease
    class SB curr1xx

1xx Band Servicing

For ongoing 1xx servicing builds.

Required inputs:

source-built SDK and artifacts from the previous 1xx release

git clone -b <1xx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# Build the SDK referencing assets from previous 1xx release
./build.sh --source-only \
  --with-sdk /path/to/source-built-1xx/sdk \
  --with-packages /path/to/source-built-1xx/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph Msft["Previous 1xx SB Release"]
        Prev_SDK[Source-built 1xx SDK]
        Prev_Art[Source-built 1xx artifacts]
    end
    
    subgraph SB["Current 1xx SB Release"]
        Build((Build Process))
        New_SDK[New 1xx SDK]
        New_Art[New 1xx Artifacts]

        Prev_SDK -.->|with-sdk| Build
        Prev_Art -.->|with-packages| Build
        Build --> New_SDK
        Build --> New_Art
    end
    
    classDef prev1xx fill:#db9b9b,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    class Msft prev1xx
    class SB curr1xx

2xx Band Initial Release (N.0.200)

Initial release of the 2xx band.

Required inputs:

source-built artifacts of the current 1xx release
source-built SDK artifacts from the previous 1xx release

git clone -b <2xx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# Build the SDK
./build.sh --source-only \
  --with-sdk /path/to/previous-source-built-1xx/sdk \
  --with-packages /path/to/previous-source-built-1xx/artifacts \
  --with-shared-components /path/to/current-source-built-1xx/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph SBPrev["Previous 1xx SB Release"]
        Prev_1xx_SDK[Source-built 1xx SDK]
        Prev_1xx_Art[Source-built 1xx artifacts]
    end
    
    subgraph SBCurrent1xx["Current SB 1xx Release"]
        Curr_1xx_Art[Current source-built<br/>1xx Artifacts]
    end
    
    subgraph SBCurrent2xx["Current SB 2xx Release"]
        Build((Build Process))
        SDK_2xx[New 2xx SDK]
        Art_2xx[New 2xx Artifacts]

        Prev_1xx_SDK -.->|with-sdk| Build
        Prev_1xx_Art -.->|with-packages| Build
        Curr_1xx_Art -.->|with-shared-components| Build
        Build --> SDK_2xx
        Build --> Art_2xx
    end
    
    classDef prev1xx fill:#db9b9b,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    classDef curr2xx fill:#3da53d,stroke:#666,stroke-width:2px,color:#000
    class SBPrev prev1xx
    class SBCurrent1xx curr1xx
    class SBCurrent2xx curr2xx

2xx Band Servicing (N.0.201+)

For ongoing 2xx servicing builds.

Required inputs:

source-built artifacts of the current 1xx release
source-built SDK and artifacts from the previous 2xx release

git clone -b <2xx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# Build the SDK
./build.sh --source-only \
  --with-sdk /path/to/previous-source-built-2xx/sdk \
  --with-packages /path/to/previous-source-built-2xx/artifacts \
  --with-shared-components /path/to/current-source-built-1xx/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph SBPrev2xx["Previous 2xx SB Release"]
        Prev_1xx_SDK[Source-built<br/>2xx SDK]
        Prev_2xx_Art[Source-built<br/>2xx Artifacts]
    end
    
    subgraph SBCurrent1xx["Current 1xx SB Release"]
        Curr_1xx_Art[Current source-built <br/>1xx Artifacts]
    end
    
    subgraph SBCurrent2xx["Current 2xx SB Release"]
        Build((Build Process))
        SDK_2xx[New 2xx SDK]
        Art_2xx[New 2xx Artifacts]
    end
    
    Prev_1xx_SDK -.->|with-sdk| Build
    Prev_2xx_Art -.->|with-packages| Build
    Curr_1xx_Art -.->|with-shared-components| Build
    Build --> SDK_2xx
    Build --> Art_2xx
    
    classDef prev2xx fill:#c98989,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    classDef curr2xx fill:#3da53d,stroke:#666,stroke-width:2px,color:#000
    class SBPrev2xx prev2xx
    class SBCurrent1xx curr1xx
    class SBCurrent2xx curr2xx

3xx/4xx Band Initial Release (N.0.B00)

For the initial Bxx release.

Required inputs:

source-built artifacts from the current 1xx release
source-built SDK and artifacts from the previous (B-1)xx release

git clone -b <Bxx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# Build the SDK
./build.sh --source-only \
  --with-sdk /path/to/previous-source-built-(B-1)xx/sdk \
  --with-packages /path/to/previous-source-built-(B-1)xx/artifacts \
  --with-shared-components /path/to/current-source-built-1xx/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph SBPrev2xx["Previous (B-1)xx SB Release"]
        Prev_2xx_SDK["Source-built (B-1)xx SDK"]
        Prev_2xx_Art["Source-built (B-1)xx Artifacts"]
    end
    
    subgraph SBCurr1xx["Current 1xx SB Release"]
        Curr_1xx_Art[Source-built 1xx artifacts]
    end
    
    subgraph SBCurr3xx["Current Bxx SB Release"]
        Build((Build Process))
        SDK_3xx[New Bxx SDK]
        Art_3xx[New Bxx Artifacts]
    end
    
    Prev_2xx_SDK -.->|with-sdk| Build
    Prev_2xx_Art -.->|with-packages| Build
    Curr_1xx_Art -.->|with-shared-components| Build
    Build --> SDK_3xx
    Build --> Art_3xx
    
    classDef prev2xx fill:#c98989,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    classDef curr3xx fill:#2d8b2d,stroke:#666,stroke-width:2px,color:#000
    class SBPrev2xx prev2xx
    class SBCurr1xx curr1xx
    class SBCurr3xx curr3xx

3xx/4xx Band Servicing (N.0.B01+)

For ongoing 3xx servicing builds.

Required inputs:

source-built artifacts from the current 1xx release
source-built SDK and artifacts from the previous Bxx release

git clone -b <Bxx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# Build the SDK
./build.sh --source-only \
  --with-sdk /path/to/previous-source-built-Bxx/sdk \
  --with-packages /path/to/previous-source-built-Bxx/artifacts \
  --with-shared-components /path/to/current-source-built-1xx/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph SBPrev3xx["Previous Bxx SB Release"]
        Prev_3xx_SDK[Source-built Bxx SDK]
        Prev_3xx_Art[Source-built Bxx artifacts]
    end
    
    subgraph SBCurr1xx["Current 1xx SB Release"]
        Curr_1xx_Art[Source-built 1xx artifacts]
    end
    
    subgraph SBCurr3xx["Current Bxx SB Release"]
        Build((Build Process))
        SDK_3xx[New Bxx SDK]
        Art_3xx[New Bxx Artifacts]
    end
    
    Prev_3xx_SDK -.->|with-sdk| Build
    Prev_3xx_Art -.->|with-packages| Build
    Curr_1xx_Art -.->|with-shared-components| Build
    Build --> SDK_3xx
    Build --> Art_3xx
    
    classDef prev3xx fill:#c98989,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    classDef curr3xx fill:#2d8b2d,stroke:#666,stroke-width:2px,color:#000
    class SBPrev3xx prev3xx
    class SBCurr1xx curr1xx
    class SBCurr3xx curr3xx

2xx/3xx/4xx Bootstrap (N.0.B00+)

For releases that require bootstrap (two-stage process).

Required inputs:

source-built artifacts from the current 1xx release

git clone -b <Bxx-release-branch> https://github.com/dotnet/dotnet.git
cd dotnet

# ===
# Stage 1: Build with Microsoft artifacts
# ===

# Downloads Microsoft-built artifacts and Microsoft SDK
./prep-source-build.sh # (.NET 10)
./prep-source-build.sh --no-shared-components # (.NET 11+)

# Build the SDK referencing assets from current 1xx release
./build.sh --source-only --with-shared-components /path/to/source-built-1xx/artifacts

# Extract and store the built Bxx SDK and artifacts
tar -ozxf artifacts/assets/Release/dotnet-sdk-*-tar.gz \
  -C /tmp/dotnet/sdk
tar -ozxf artifacts/assets/Release/Private.SourceBuilt.Artifacts.*.tar.gz \
  -C /tmp/dotnet/artifacts

# ===
# Stage 2: Rebuild using stage 1 outputs
# ===

./build.sh --source-only \
  --with-sdk /tmp/dotnet/sdk \
  --with-packages /tmp/dotnet/artifacts \
  --with-shared-components /tmp/dotnet/artifacts

# Final source-built outputs available in artifacts/x64/Release/

flowchart LR
    subgraph MS["Previous MS Release"]
        MS_SDK[Microsoft-built SDK]
        MS_Art[Microsoft-built artifacts]
    end
    
    subgraph SBCurr1xx["Current 1xx SB Release"]
        SB_1xx[Source-built 1xx artifacts]
    end
    
    subgraph SBCurr3xx["Current Bxx SB Release"]
        subgraph Stage1["Stage 1: Bootstrap Build"]
            Build1((Build Process))
            S1_SDK[Stage 1 Bxx SDK]
            S1_Art[Stage 1 Bxx artifacts]
        end

        subgraph Stage2["Stage 2: Build"]
            Build2((Build Process))
            Final_SDK[Final Bxx SDK]
            Final_Art[Final Bxx artifacts]
        end
    end
    
    MS_SDK -.->|with-sdk| Build1
    MS_Art -.->|with-packages| Build1
    SB_1xx -.->|with-shared-components| Build1
    Build1 --> S1_SDK
    Build1 --> S1_Art
    S1_SDK -.->|with-sdk| Build2
    S1_Art -.->|with-packages| Build2
    S1_Art -.->|with-shared-components| Build2
    Build2 --> Final_SDK
    Build2 --> Final_Art
    
    classDef msRelease fill:#9b9bdb,stroke:#666,stroke-width:2px,color:#000
    classDef curr1xx fill:#5bb75b,stroke:#666,stroke-width:2px,color:#000
    classDef curr3xx fill:#2d8b2d,stroke:#666,stroke-width:2px,color:#000
    class MS msRelease
    class SBCurr1xx curr1xx
    class SBCurr3xx curr3xx

Troubleshooting

Error: Shared components cannot be provided as input to a build which produces shared components

Explanation: You're building the 1xx band (main or N.0.1xx branch) and providing shared component artifacts as input. The 1xx band produces shared components, so it doesn't consume them as inputs.
Resolution: Exclude the --with-shared-components parameter from the build.sh script.

Error: Shared components must be provided as input to a build which does not produce shared components

Explanation: You're building a 2xx, 3xx, or 4xx band and not providing shared component artifacts as input. These bands require shared components from the 1xx band because they provide the necessary runtime and foundational components for the SDK.
Resolution: Include the --with-shared-components parameter for the build.sh script.

Poison and Prebuilt Detection

The poison detection system treats shared component and PSB artifacts differently:

PSB artifacts: Subject to poison detection to prevent Microsoft binaries in output
Shared component artifacts: Not poisoned since they're shared components from the same source-build iteration
Prebuilt detection: Shared component inputs are not considered prebuilts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

.NET VMR Feature Band Source Building Guide for Linux Distro Maintainers

Table of Contents

What are .NET SDK Feature Bands?

Key Terminology

Overview

Understanding Bootstrap vs Sequential Build

Bootstrap Process (Two-Stage)

Sequential Build (Single-Stage)

Required Build Inputs

Previously Source-Built (PSB) Artifacts

Shared Component Artifacts

Feature Band Characteristics

1xx Band (GA/Non-breaking)

2xx Band

3xx/4xx Band

Build Requirements by Feature Band

1xx Band Build Requirements

2xx Band Build Requirements

3xx/4xx Band Build Requirements

Feature Band Key Points

Build Command Arguments

Distro Maintainer Workflows

Input Artifacts Summary

1xx Band Bootstrap

1xx Band Servicing

2xx Band Initial Release (N.0.200)

2xx Band Servicing (N.0.201+)

3xx/4xx Band Initial Release (N.0.B00)

3xx/4xx Band Servicing (N.0.B01+)

2xx/3xx/4xx Bootstrap (N.0.B00+)

Troubleshooting

Poison and Prebuilt Detection

Additional Resources

FilesExpand file tree

feature-band-source-building.md

Latest commit

History

feature-band-source-building.md

File metadata and controls

.NET VMR Feature Band Source Building Guide for Linux Distro Maintainers

Table of Contents

What are .NET SDK Feature Bands?

Key Terminology

Overview

Understanding Bootstrap vs Sequential Build

Bootstrap Process (Two-Stage)

Sequential Build (Single-Stage)

Required Build Inputs

Previously Source-Built (PSB) Artifacts

Shared Component Artifacts

Feature Band Characteristics

1xx Band (GA/Non-breaking)

2xx Band

3xx/4xx Band

Build Requirements by Feature Band

1xx Band Build Requirements

2xx Band Build Requirements

3xx/4xx Band Build Requirements

Feature Band Key Points

Build Command Arguments

Distro Maintainer Workflows

Input Artifacts Summary

1xx Band Bootstrap

1xx Band Servicing

2xx Band Initial Release (N.0.200)

2xx Band Servicing (N.0.201+)

3xx/4xx Band Initial Release (N.0.B00)

3xx/4xx Band Servicing (N.0.B01+)

2xx/3xx/4xx Bootstrap (N.0.B00+)

Troubleshooting

Poison and Prebuilt Detection

Additional Resources