1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2/*
3 * This file contains volume label definitions for DASD devices.
4 *
5 * Copyright IBM Corp. 2005
6 *
7 * Author(s): Volker Sameske <sameske@de.ibm.com>
8 *
9 */
10
11#ifndef _ASM_S390_VTOC_H
12#define _ASM_S390_VTOC_H
13
14#include <linux/types.h>
15
16struct vtoc_ttr
17{
18	__u16 tt;
19	__u8 r;
20} __attribute__ ((packed));
21
22struct vtoc_cchhb
23{
24	__u16 cc;
25	__u16 hh;
26	__u8 b;
27} __attribute__ ((packed));
28
29struct vtoc_cchh
30{
31	__u16 cc;
32	__u16 hh;
33} __attribute__ ((packed));
34
35struct vtoc_labeldate
36{
37	__u8 year;
38	__u16 day;
39} __attribute__ ((packed));
40
41struct vtoc_volume_label_cdl
42{
43	char volkey[4];		/* volume key = volume label */
44	char vollbl[4];		/* volume label */
45	char volid[6];		/* volume identifier */
46	__u8 security;		/* security byte */
47	struct vtoc_cchhb vtoc;	/* VTOC address */
48	char res1[5];		/* reserved */
49	char cisize[4];		/* CI-size for FBA,... */
50				/* ...blanks for CKD */
51	char blkperci[4];	/* no of blocks per CI (FBA), blanks for CKD */
52	char labperci[4];	/* no of labels per CI (FBA), blanks for CKD */
53	char res2[4];		/* reserved */
54	char lvtoc[14];		/* owner code for LVTOC */
55	char res3[29];		/* reserved */
56} __attribute__ ((packed));
57
58struct vtoc_volume_label_ldl {
59	char vollbl[4];		/* volume label */
60	char volid[6];		/* volume identifier */
61	char res3[69];		/* reserved */
62	char ldl_version;	/* version number, valid for ldl format */
63	__u64 formatted_blocks; /* valid when ldl_version >= f2  */
64} __attribute__ ((packed));
65
66struct vtoc_extent
67{
68	__u8 typeind;			/* extent type indicator */
69	__u8 seqno;			/* extent sequence number */
70	struct vtoc_cchh llimit;	/* starting point of this extent */
71	struct vtoc_cchh ulimit;	/* ending point of this extent */
72} __attribute__ ((packed));
73
74struct vtoc_dev_const
75{
76	__u16 DS4DSCYL;	/* number of logical cyls */
77	__u16 DS4DSTRK;	/* number of tracks in a logical cylinder */
78	__u16 DS4DEVTK;	/* device track length */
79	__u8 DS4DEVI;	/* non-last keyed record overhead */
80	__u8 DS4DEVL;	/* last keyed record overhead */
81	__u8 DS4DEVK;	/* non-keyed record overhead differential */
82	__u8 DS4DEVFG;	/* flag byte */
83	__u16 DS4DEVTL;	/* device tolerance */
84	__u8 DS4DEVDT;	/* number of DSCB's per track */
85	__u8 DS4DEVDB;	/* number of directory blocks per track */
86} __attribute__ ((packed));
87
88struct vtoc_format1_label
89{
90	char DS1DSNAM[44];	/* data set name */
91	__u8 DS1FMTID;		/* format identifier */
92	char DS1DSSN[6];	/* data set serial number */
93	__u16 DS1VOLSQ;		/* volume sequence number */
94	struct vtoc_labeldate DS1CREDT; /* creation date: ydd */
95	struct vtoc_labeldate DS1EXPDT; /* expiration date */
96	__u8 DS1NOEPV;		/* number of extents on volume */
97	__u8 DS1NOBDB;		/* no. of bytes used in last direction blk */
98	__u8 DS1FLAG1;		/* flag 1 */
99	char DS1SYSCD[13];	/* system code */
100	struct vtoc_labeldate DS1REFD; /* date last referenced	*/
101	__u8 DS1SMSFG;		/* system managed storage indicators */
102	__u8 DS1SCXTF;		/* sec. space extension flag byte */
103	__u16 DS1SCXTV;		/* secondary space extension value */
104	__u8 DS1DSRG1;		/* data set organisation byte 1 */
105	__u8 DS1DSRG2;		/* data set organisation byte 2 */
106	__u8 DS1RECFM;		/* record format */
107	__u8 DS1OPTCD;		/* option code */
108	__u16 DS1BLKL;		/* block length */
109	__u16 DS1LRECL;		/* record length */
110	__u8 DS1KEYL;		/* key length */
111	__u16 DS1RKP;		/* relative key position */
112	__u8 DS1DSIND;		/* data set indicators */
113	__u8 DS1SCAL1;		/* secondary allocation flag byte */
114	char DS1SCAL3[3];	/* secondary allocation quantity */
115	struct vtoc_ttr DS1LSTAR; /* last used track and block on track */
116	__u16 DS1TRBAL;		/* space remaining on last used track */
117	__u16 res1;		/* reserved */
118	struct vtoc_extent DS1EXT1; /* first extent description */
119	struct vtoc_extent DS1EXT2; /* second extent description */
120	struct vtoc_extent DS1EXT3; /* third extent description */
121	struct vtoc_cchhb DS1PTRDS; /* possible pointer to f2 or f3 DSCB */
122} __attribute__ ((packed));
123
124struct vtoc_format4_label
125{
126	char DS4KEYCD[44];	/* key code for VTOC labels: 44 times 0x04 */
127	__u8 DS4IDFMT;		/* format identifier */
128	struct vtoc_cchhb DS4HPCHR; /* highest address of a format 1 DSCB */
129	__u16 DS4DSREC;		/* number of available DSCB's */
130	struct vtoc_cchh DS4HCCHH; /* CCHH of next available alternate track */
131	__u16 DS4NOATK;		/* number of remaining alternate tracks */
132	__u8 DS4VTOCI;		/* VTOC indicators */
133	__u8 DS4NOEXT;		/* number of extents in VTOC */
134	__u8 DS4SMSFG;		/* system managed storage indicators */
135	__u8 DS4DEVAC;		/* number of alternate cylinders.
136				 * Subtract from first two bytes of
137				 * DS4DEVSZ to get number of usable
138				 * cylinders. can be zero. valid
139				 * only if DS4DEVAV on. */
140	struct vtoc_dev_const DS4DEVCT;	/* device constants */
141	char DS4AMTIM[8];	/* VSAM time stamp */
142	char DS4AMCAT[3];	/* VSAM catalog indicator */
143	char DS4R2TIM[8];	/* VSAM volume/catalog match time stamp */
144	char res1[5];		/* reserved */
145	char DS4F6PTR[5];	/* pointer to first format 6 DSCB */
146	struct vtoc_extent DS4VTOCE; /* VTOC extent description */
147	char res2[10];		/* reserved */
148	__u8 DS4EFLVL;		/* extended free-space management level */
149	struct vtoc_cchhb DS4EFPTR; /* pointer to extended free-space info */
150	char res3;		/* reserved */
151	__u32 DS4DCYL;		/* number of logical cyls */
152	char res4[2];		/* reserved */
153	__u8 DS4DEVF2;		/* device flags */
154	char res5;		/* reserved */
155} __attribute__ ((packed));
156
157struct vtoc_ds5ext
158{
159	__u16 t;	/* RTA of the first track of free extent */
160	__u16 fc;	/* number of whole cylinders in free ext. */
161	__u8 ft;	/* number of remaining free tracks */
162} __attribute__ ((packed));
163
164struct vtoc_format5_label
165{
166	char DS5KEYID[4];	/* key identifier */
167	struct vtoc_ds5ext DS5AVEXT; /* first available (free-space) extent. */
168	struct vtoc_ds5ext DS5EXTAV[7]; /* seven available extents */
169	__u8 DS5FMTID;		/* format identifier */
170	struct vtoc_ds5ext DS5MAVET[18]; /* eighteen available extents */
171	struct vtoc_cchhb DS5PTRDS; /* pointer to next format5 DSCB */
172} __attribute__ ((packed));
173
174struct vtoc_ds7ext
175{
176	__u32 a; /* starting RTA value */
177	__u32 b; /* ending RTA value + 1 */
178} __attribute__ ((packed));
179
180struct vtoc_format7_label
181{
182	char DS7KEYID[4];	/* key identifier */
183	struct vtoc_ds7ext DS7EXTNT[5]; /* space for 5 extent descriptions */
184	__u8 DS7FMTID;		/* format identifier */
185	struct vtoc_ds7ext DS7ADEXT[11]; /* space for 11 extent descriptions */
186	char res1[2];		/* reserved */
187	struct vtoc_cchhb DS7PTRDS; /* pointer to next FMT7 DSCB */
188} __attribute__ ((packed));
189
190struct vtoc_cms_label {
191	__u8 label_id[4];		/* Label identifier */
192	__u8 vol_id[6];		/* Volid */
193	__u16 version_id;		/* Version identifier */
194	__u32 block_size;		/* Disk block size */
195	__u32 origin_ptr;		/* Disk origin pointer */
196	__u32 usable_count;	/* Number of usable cylinders/blocks */
197	__u32 formatted_count;	/* Maximum number of formatted cylinders/
198				 * blocks */
199	__u32 block_count;	/* Disk size in CMS blocks */
200	__u32 used_count;		/* Number of CMS blocks in use */
201	__u32 fst_size;		/* File Status Table (FST) size */
202	__u32 fst_count;		/* Number of FSTs per CMS block */
203	__u8 format_date[6];	/* Disk FORMAT date */
204	__u8 reserved1[2];
205	__u32 disk_offset;	/* Disk offset when reserved*/
206	__u32 map_block;		/* Allocation Map Block with next hole */
207	__u32 hblk_disp;		/* Displacement into HBLK data of next hole */
208	__u32 user_disp;		/* Displacement into user part of Allocation
209				 * map */
210	__u8 reserved2[4];
211	__u8 segment_name[8];	/* Name of shared segment */
212} __attribute__ ((packed));
213
214#endif /* _ASM_S390_VTOC_H */
215