arch/s390/include/uapi/asm/vtoc.h
Source file repositories/reference/linux-study-clean/arch/s390/include/uapi/asm/vtoc.h
File Facts
- System
- Linux kernel
- Corpus path
arch/s390/include/uapi/asm/vtoc.h- Extension
.h- Size
- 7539 bytes
- Lines
- 215
- Domain
- Architecture Layer
- Bucket
- arch/s390
- Inferred role
- Architecture Layer: implementation source
- Status
- source implementation candidate
Why This File Exists
CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- CPU and platform-specific kernel glue: boot entry, traps, syscall entry, interrupts, page tables, context switch, and low-level barriers.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/types.h
Detected Declarations
struct vtoc_ttrstruct vtoc_cchhbstruct vtoc_cchhstruct vtoc_labeldatestruct vtoc_volume_label_cdlstruct vtoc_volume_label_ldlstruct vtoc_extentstruct vtoc_dev_conststruct vtoc_format1_labelstruct vtoc_format4_labelstruct vtoc_ds5extstruct vtoc_format5_labelstruct vtoc_ds7extstruct vtoc_format7_labelstruct vtoc_cms_label
Annotated Snippet
struct vtoc_volume_label_ldl {
char vollbl[4]; /* volume label */
char volid[6]; /* volume identifier */
char res3[69]; /* reserved */
char ldl_version; /* version number, valid for ldl format */
__u64 formatted_blocks; /* valid when ldl_version >= f2 */
} __attribute__ ((packed));
struct vtoc_extent
{
__u8 typeind; /* extent type indicator */
__u8 seqno; /* extent sequence number */
struct vtoc_cchh llimit; /* starting point of this extent */
struct vtoc_cchh ulimit; /* ending point of this extent */
} __attribute__ ((packed));
struct vtoc_dev_const
{
__u16 DS4DSCYL; /* number of logical cyls */
__u16 DS4DSTRK; /* number of tracks in a logical cylinder */
__u16 DS4DEVTK; /* device track length */
__u8 DS4DEVI; /* non-last keyed record overhead */
__u8 DS4DEVL; /* last keyed record overhead */
__u8 DS4DEVK; /* non-keyed record overhead differential */
__u8 DS4DEVFG; /* flag byte */
__u16 DS4DEVTL; /* device tolerance */
__u8 DS4DEVDT; /* number of DSCB's per track */
__u8 DS4DEVDB; /* number of directory blocks per track */
} __attribute__ ((packed));
struct vtoc_format1_label
{
char DS1DSNAM[44]; /* data set name */
__u8 DS1FMTID; /* format identifier */
char DS1DSSN[6]; /* data set serial number */
__u16 DS1VOLSQ; /* volume sequence number */
struct vtoc_labeldate DS1CREDT; /* creation date: ydd */
struct vtoc_labeldate DS1EXPDT; /* expiration date */
__u8 DS1NOEPV; /* number of extents on volume */
__u8 DS1NOBDB; /* no. of bytes used in last direction blk */
__u8 DS1FLAG1; /* flag 1 */
char DS1SYSCD[13]; /* system code */
struct vtoc_labeldate DS1REFD; /* date last referenced */
__u8 DS1SMSFG; /* system managed storage indicators */
__u8 DS1SCXTF; /* sec. space extension flag byte */
__u16 DS1SCXTV; /* secondary space extension value */
__u8 DS1DSRG1; /* data set organisation byte 1 */
__u8 DS1DSRG2; /* data set organisation byte 2 */
__u8 DS1RECFM; /* record format */
__u8 DS1OPTCD; /* option code */
__u16 DS1BLKL; /* block length */
__u16 DS1LRECL; /* record length */
__u8 DS1KEYL; /* key length */
__u16 DS1RKP; /* relative key position */
__u8 DS1DSIND; /* data set indicators */
__u8 DS1SCAL1; /* secondary allocation flag byte */
char DS1SCAL3[3]; /* secondary allocation quantity */
struct vtoc_ttr DS1LSTAR; /* last used track and block on track */
__u16 DS1TRBAL; /* space remaining on last used track */
__u16 res1; /* reserved */
struct vtoc_extent DS1EXT1; /* first extent description */
struct vtoc_extent DS1EXT2; /* second extent description */
struct vtoc_extent DS1EXT3; /* third extent description */
struct vtoc_cchhb DS1PTRDS; /* possible pointer to f2 or f3 DSCB */
} __attribute__ ((packed));
struct vtoc_format4_label
{
char DS4KEYCD[44]; /* key code for VTOC labels: 44 times 0x04 */
__u8 DS4IDFMT; /* format identifier */
struct vtoc_cchhb DS4HPCHR; /* highest address of a format 1 DSCB */
__u16 DS4DSREC; /* number of available DSCB's */
struct vtoc_cchh DS4HCCHH; /* CCHH of next available alternate track */
__u16 DS4NOATK; /* number of remaining alternate tracks */
__u8 DS4VTOCI; /* VTOC indicators */
__u8 DS4NOEXT; /* number of extents in VTOC */
__u8 DS4SMSFG; /* system managed storage indicators */
__u8 DS4DEVAC; /* number of alternate cylinders.
* Subtract from first two bytes of
* DS4DEVSZ to get number of usable
* cylinders. can be zero. valid
* only if DS4DEVAV on. */
struct vtoc_dev_const DS4DEVCT; /* device constants */
char DS4AMTIM[8]; /* VSAM time stamp */
char DS4AMCAT[3]; /* VSAM catalog indicator */
char DS4R2TIM[8]; /* VSAM volume/catalog match time stamp */
char res1[5]; /* reserved */
char DS4F6PTR[5]; /* pointer to first format 6 DSCB */
struct vtoc_extent DS4VTOCE; /* VTOC extent description */
char res2[10]; /* reserved */
Annotation
- Immediate include surface: `linux/types.h`.
- Detected declarations: `struct vtoc_ttr`, `struct vtoc_cchhb`, `struct vtoc_cchh`, `struct vtoc_labeldate`, `struct vtoc_volume_label_cdl`, `struct vtoc_volume_label_ldl`, `struct vtoc_extent`, `struct vtoc_dev_const`, `struct vtoc_format1_label`, `struct vtoc_format4_label`.
- Atlas domain: Architecture Layer / arch/s390.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.