2019-11-21 19:18:07

by Pascal Terjan

[permalink] [raw]
Subject: [PATCH] Delete obsolete magic constants from documentation

Those no longer appear in the code.
I have some more patches to cleanup some of them from the code but this
is an easy first step.

Signed-off-by: Pascal Terjan <[email protected]>
---
Documentation/process/magic-number.rst | 44 -------------------
.../it_IT/process/magic-number.rst | 44 -------------------
.../zh_CN/process/magic-number.rst | 44 -------------------
3 files changed, 132 deletions(-)

diff --git a/Documentation/process/magic-number.rst b/Documentation/process/magic-number.rst
index eee9b44553b3..16f6a4a97c1e 100644
--- a/Documentation/process/magic-number.rst
+++ b/Documentation/process/magic-number.rst
@@ -70,77 +70,34 @@ Magic Name Number Structure File
===================== ================ ======================== ==========================================
PG_MAGIC 'P' pg_{read,write}_hdr ``include/linux/pg.h``
CMAGIC 0x0111 user ``include/linux/a.out.h``
-MKISS_DRIVER_MAGIC 0x04bf mkiss_channel ``drivers/net/mkiss.h``
HDLC_MAGIC 0x239e n_hdlc ``drivers/char/n_hdlc.c``
APM_BIOS_MAGIC 0x4101 apm_user ``arch/x86/kernel/apm_32.c``
CYCLADES_MAGIC 0x4359 cyclades_port ``include/linux/cyclades.h``
-DB_MAGIC 0x4442 fc_info ``drivers/net/iph5526_novram.c``
-DL_MAGIC 0x444d fc_info ``drivers/net/iph5526_novram.c``
FASYNC_MAGIC 0x4601 fasync_struct ``include/linux/fs.h``
-FF_MAGIC 0x4646 fc_info ``drivers/net/iph5526_novram.c``
ISICOM_MAGIC 0x4d54 isi_port ``include/linux/isicom.h``
-PTY_MAGIC 0x5001 ``drivers/char/pty.c``
-PPP_MAGIC 0x5002 ppp ``include/linux/if_pppvar.h``
-SSTATE_MAGIC 0x5302 serial_state ``include/linux/serial.h``
SLIP_MAGIC 0x5302 slip ``drivers/net/slip.h``
-STRIP_MAGIC 0x5303 strip ``drivers/net/strip.c``
X25_ASY_MAGIC 0x5303 x25_asy ``drivers/net/x25_asy.h``
-SIXPACK_MAGIC 0x5304 sixpack ``drivers/net/hamradio/6pack.h``
-AX25_MAGIC 0x5316 ax_disp ``drivers/net/mkiss.h``
TTY_MAGIC 0x5401 tty_struct ``include/linux/tty.h``
MGSL_MAGIC 0x5401 mgsl_info ``drivers/char/synclink.c``
TTY_DRIVER_MAGIC 0x5402 tty_driver ``include/linux/tty_driver.h``
MGSLPC_MAGIC 0x5402 mgslpc_info ``drivers/char/pcmcia/synclink_cs.c``
TTY_LDISC_MAGIC 0x5403 tty_ldisc ``include/linux/tty_ldisc.h``
-USB_SERIAL_MAGIC 0x6702 usb_serial ``drivers/usb/serial/usb-serial.h``
FULL_DUPLEX_MAGIC 0x6969 ``drivers/net/ethernet/dec/tulip/de2104x.c``
-USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth ``drivers/usb/class/bluetty.c``
RFCOMM_TTY_MAGIC 0x6d02 ``net/bluetooth/rfcomm/tty.c``
-USB_SERIAL_PORT_MAGIC 0x7301 usb_serial_port ``drivers/usb/serial/usb-serial.h``
CG_MAGIC 0x00090255 ufs_cylinder_group ``include/linux/ufs_fs.h``
RPORT_MAGIC 0x00525001 r_port ``drivers/char/rocket_int.h``
-LSEMAGIC 0x05091998 lse ``drivers/fc4/fc.c``
GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str ``drivers/scsi/gdth_ioctl.h``
RIEBL_MAGIC 0x09051990 ``drivers/net/atarilance.c``
NBD_REQUEST_MAGIC 0x12560953 nbd_request ``include/linux/nbd.h``
-RED_MAGIC2 0x170fc2a5 (any) ``mm/slab.c``
BAYCOM_MAGIC 0x19730510 baycom_state ``drivers/net/baycom_epp.c``
-ISDN_X25IFACE_MAGIC 0x1e75a2b9 isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h``
-ECP_MAGIC 0x21504345 cdkecpsig ``include/linux/cdk.h``
-LSOMAGIC 0x27091997 lso ``drivers/fc4/fc.c``
-LSMAGIC 0x2a3b4d2a ls ``drivers/fc4/fc.c``
-WANPIPE_MAGIC 0x414C4453 sdla_{dump,exec} ``include/linux/wanpipe.h``
-CS_CARD_MAGIC 0x43525553 cs_card ``sound/oss/cs46xx.c``
-LABELCL_MAGIC 0x4857434c labelcl_info_s ``include/asm/ia64/sn/labelcl.h``
-ISDN_ASYNC_MAGIC 0x49344C01 modem_info ``include/linux/isdn.h``
-CTC_ASYNC_MAGIC 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
-ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s ``drivers/isdn/i4l/isdn_net_lib.h``
SAVEKMSG_MAGIC2 0x4B4D5347 savekmsg ``arch/*/amiga/config.c``
-CS_STATE_MAGIC 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
-SLAB_C_MAGIC 0x4f17a36d kmem_cache ``mm/slab.c``
COW_MAGIC 0x4f4f4f4d cow_header_v1 ``arch/um/drivers/ubd_user.c``
-I810_CARD_MAGIC 0x5072696E i810_card ``sound/oss/i810_audio.c``
-TRIDENT_CARD_MAGIC 0x5072696E trident_card ``sound/oss/trident.c``
-ROUTER_MAGIC 0x524d4157 wan_device [in ``wanrouter.h`` pre 3.9]
SAVEKMSG_MAGIC1 0x53415645 savekmsg ``arch/*/amiga/config.c``
GDA_MAGIC 0x58464552 gda ``arch/mips/include/asm/sn/gda.h``
-RED_MAGIC1 0x5a2cf071 (any) ``mm/slab.c``
EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev ``drivers/atm/lanai.c``
HDLCDRV_MAGIC 0x5ac6e778 hdlcdrv_state ``include/linux/hdlcdrv.h``
-PCXX_MAGIC 0x5c6df104 channel ``drivers/char/pcxx.h``
KV_MAGIC 0x5f4b565f kernel_vars_s ``arch/mips/include/asm/sn/klkernvars.h``
-I810_STATE_MAGIC 0x63657373 i810_state ``sound/oss/i810_audio.c``
-TRIDENT_STATE_MAGIC 0x63657373 trient_state ``sound/oss/trident.c``
-M3_CARD_MAGIC 0x646e6f50 m3_card ``sound/oss/maestro3.c``
FW_HEADER_MAGIC 0x65726F66 fw_header ``drivers/atm/fore200e.h``
-SLOT_MAGIC 0x67267321 slot ``drivers/hotplug/cpqphp.h``
-SLOT_MAGIC 0x67267322 slot ``drivers/hotplug/acpiphp.h``
-LO_MAGIC 0x68797548 nbd_device ``include/linux/nbd.h``
-OPROFILE_MAGIC 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
-M3_STATE_MAGIC 0x734d724d m3_state ``sound/oss/maestro3.c``
-VMALLOC_MAGIC 0x87654320 snd_alloc_track ``sound/core/memory.c``
-KMALLOC_MAGIC 0x87654321 snd_alloc_track ``sound/core/memory.c``
-PWC_MAGIC 0x89DC10AB pwc_device ``drivers/usb/media/pwc.h``
NBD_REPLY_MAGIC 0x96744668 nbd_reply ``include/linux/nbd.h``
ENI155_MAGIC 0xa54b872d midway_eprom ``drivers/atm/eni.h``
CODA_MAGIC 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h``
@@ -149,7 +106,6 @@ YAM_MAGIC 0xF10A7654 yam_port ``drivers/net/ha
CCB_MAGIC 0xf2691ad2 ccb ``drivers/scsi/ncr53c8xx.c``
QUEUE_MAGIC_FREE 0xf7e1c9a3 queue_entry ``drivers/scsi/arm/queue.c``
QUEUE_MAGIC_USED 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
-HTB_CMAGIC 0xFEFAFEF1 htb_class ``net/sched/sch_htb.c``
NMI_MAGIC 0x48414d4d455201 nmi_s ``arch/mips/include/asm/sn/nmi.h``
===================== ================ ======================== ==========================================

diff --git a/Documentation/translations/it_IT/process/magic-number.rst b/Documentation/translations/it_IT/process/magic-number.rst
index 783e0de314a0..823acaee8805 100644
--- a/Documentation/translations/it_IT/process/magic-number.rst
+++ b/Documentation/translations/it_IT/process/magic-number.rst
@@ -76,77 +76,34 @@ Nome magico Numero Struttura File
===================== ================ ======================== ==========================================
PG_MAGIC 'P' pg_{read,write}_hdr ``include/linux/pg.h``
CMAGIC 0x0111 user ``include/linux/a.out.h``
-MKISS_DRIVER_MAGIC 0x04bf mkiss_channel ``drivers/net/mkiss.h``
HDLC_MAGIC 0x239e n_hdlc ``drivers/char/n_hdlc.c``
APM_BIOS_MAGIC 0x4101 apm_user ``arch/x86/kernel/apm_32.c``
CYCLADES_MAGIC 0x4359 cyclades_port ``include/linux/cyclades.h``
-DB_MAGIC 0x4442 fc_info ``drivers/net/iph5526_novram.c``
-DL_MAGIC 0x444d fc_info ``drivers/net/iph5526_novram.c``
FASYNC_MAGIC 0x4601 fasync_struct ``include/linux/fs.h``
-FF_MAGIC 0x4646 fc_info ``drivers/net/iph5526_novram.c``
ISICOM_MAGIC 0x4d54 isi_port ``include/linux/isicom.h``
-PTY_MAGIC 0x5001 ``drivers/char/pty.c``
-PPP_MAGIC 0x5002 ppp ``include/linux/if_pppvar.h``
-SSTATE_MAGIC 0x5302 serial_state ``include/linux/serial.h``
SLIP_MAGIC 0x5302 slip ``drivers/net/slip.h``
-STRIP_MAGIC 0x5303 strip ``drivers/net/strip.c``
X25_ASY_MAGIC 0x5303 x25_asy ``drivers/net/x25_asy.h``
-SIXPACK_MAGIC 0x5304 sixpack ``drivers/net/hamradio/6pack.h``
-AX25_MAGIC 0x5316 ax_disp ``drivers/net/mkiss.h``
TTY_MAGIC 0x5401 tty_struct ``include/linux/tty.h``
MGSL_MAGIC 0x5401 mgsl_info ``drivers/char/synclink.c``
TTY_DRIVER_MAGIC 0x5402 tty_driver ``include/linux/tty_driver.h``
MGSLPC_MAGIC 0x5402 mgslpc_info ``drivers/char/pcmcia/synclink_cs.c``
TTY_LDISC_MAGIC 0x5403 tty_ldisc ``include/linux/tty_ldisc.h``
-USB_SERIAL_MAGIC 0x6702 usb_serial ``drivers/usb/serial/usb-serial.h``
FULL_DUPLEX_MAGIC 0x6969 ``drivers/net/ethernet/dec/tulip/de2104x.c``
-USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth ``drivers/usb/class/bluetty.c``
RFCOMM_TTY_MAGIC 0x6d02 ``net/bluetooth/rfcomm/tty.c``
-USB_SERIAL_PORT_MAGIC 0x7301 usb_serial_port ``drivers/usb/serial/usb-serial.h``
CG_MAGIC 0x00090255 ufs_cylinder_group ``include/linux/ufs_fs.h``
RPORT_MAGIC 0x00525001 r_port ``drivers/char/rocket_int.h``
-LSEMAGIC 0x05091998 lse ``drivers/fc4/fc.c``
GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str ``drivers/scsi/gdth_ioctl.h``
RIEBL_MAGIC 0x09051990 ``drivers/net/atarilance.c``
NBD_REQUEST_MAGIC 0x12560953 nbd_request ``include/linux/nbd.h``
-RED_MAGIC2 0x170fc2a5 (any) ``mm/slab.c``
BAYCOM_MAGIC 0x19730510 baycom_state ``drivers/net/baycom_epp.c``
-ISDN_X25IFACE_MAGIC 0x1e75a2b9 isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h``
-ECP_MAGIC 0x21504345 cdkecpsig ``include/linux/cdk.h``
-LSOMAGIC 0x27091997 lso ``drivers/fc4/fc.c``
-LSMAGIC 0x2a3b4d2a ls ``drivers/fc4/fc.c``
-WANPIPE_MAGIC 0x414C4453 sdla_{dump,exec} ``include/linux/wanpipe.h``
-CS_CARD_MAGIC 0x43525553 cs_card ``sound/oss/cs46xx.c``
-LABELCL_MAGIC 0x4857434c labelcl_info_s ``include/asm/ia64/sn/labelcl.h``
-ISDN_ASYNC_MAGIC 0x49344C01 modem_info ``include/linux/isdn.h``
-CTC_ASYNC_MAGIC 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
-ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s ``drivers/isdn/i4l/isdn_net_lib.h``
SAVEKMSG_MAGIC2 0x4B4D5347 savekmsg ``arch/*/amiga/config.c``
-CS_STATE_MAGIC 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
-SLAB_C_MAGIC 0x4f17a36d kmem_cache ``mm/slab.c``
COW_MAGIC 0x4f4f4f4d cow_header_v1 ``arch/um/drivers/ubd_user.c``
-I810_CARD_MAGIC 0x5072696E i810_card ``sound/oss/i810_audio.c``
-TRIDENT_CARD_MAGIC 0x5072696E trident_card ``sound/oss/trident.c``
-ROUTER_MAGIC 0x524d4157 wan_device [in ``wanrouter.h`` pre 3.9]
SAVEKMSG_MAGIC1 0x53415645 savekmsg ``arch/*/amiga/config.c``
GDA_MAGIC 0x58464552 gda ``arch/mips/include/asm/sn/gda.h``
-RED_MAGIC1 0x5a2cf071 (any) ``mm/slab.c``
EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev ``drivers/atm/lanai.c``
HDLCDRV_MAGIC 0x5ac6e778 hdlcdrv_state ``include/linux/hdlcdrv.h``
-PCXX_MAGIC 0x5c6df104 channel ``drivers/char/pcxx.h``
KV_MAGIC 0x5f4b565f kernel_vars_s ``arch/mips/include/asm/sn/klkernvars.h``
-I810_STATE_MAGIC 0x63657373 i810_state ``sound/oss/i810_audio.c``
-TRIDENT_STATE_MAGIC 0x63657373 trient_state ``sound/oss/trident.c``
-M3_CARD_MAGIC 0x646e6f50 m3_card ``sound/oss/maestro3.c``
FW_HEADER_MAGIC 0x65726F66 fw_header ``drivers/atm/fore200e.h``
-SLOT_MAGIC 0x67267321 slot ``drivers/hotplug/cpqphp.h``
-SLOT_MAGIC 0x67267322 slot ``drivers/hotplug/acpiphp.h``
-LO_MAGIC 0x68797548 nbd_device ``include/linux/nbd.h``
-OPROFILE_MAGIC 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
-M3_STATE_MAGIC 0x734d724d m3_state ``sound/oss/maestro3.c``
-VMALLOC_MAGIC 0x87654320 snd_alloc_track ``sound/core/memory.c``
-KMALLOC_MAGIC 0x87654321 snd_alloc_track ``sound/core/memory.c``
-PWC_MAGIC 0x89DC10AB pwc_device ``drivers/usb/media/pwc.h``
NBD_REPLY_MAGIC 0x96744668 nbd_reply ``include/linux/nbd.h``
ENI155_MAGIC 0xa54b872d midway_eprom ``drivers/atm/eni.h``
CODA_MAGIC 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h``
@@ -155,7 +112,6 @@ YAM_MAGIC 0xF10A7654 yam_port ``drivers/net/ha
CCB_MAGIC 0xf2691ad2 ccb ``drivers/scsi/ncr53c8xx.c``
QUEUE_MAGIC_FREE 0xf7e1c9a3 queue_entry ``drivers/scsi/arm/queue.c``
QUEUE_MAGIC_USED 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
-HTB_CMAGIC 0xFEFAFEF1 htb_class ``net/sched/sch_htb.c``
NMI_MAGIC 0x48414d4d455201 nmi_s ``arch/mips/include/asm/sn/nmi.h``
===================== ================ ======================== ==========================================

diff --git a/Documentation/translations/zh_CN/process/magic-number.rst b/Documentation/translations/zh_CN/process/magic-number.rst
index e4c225996af0..31669c1cfaa6 100644
--- a/Documentation/translations/zh_CN/process/magic-number.rst
+++ b/Documentation/translations/zh_CN/process/magic-number.rst
@@ -59,77 +59,34 @@ Linux 魔术数
===================== ================ ======================== ==========================================
PG_MAGIC 'P' pg_{read,write}_hdr ``include/linux/pg.h``
CMAGIC 0x0111 user ``include/linux/a.out.h``
-MKISS_DRIVER_MAGIC 0x04bf mkiss_channel ``drivers/net/mkiss.h``
HDLC_MAGIC 0x239e n_hdlc ``drivers/char/n_hdlc.c``
APM_BIOS_MAGIC 0x4101 apm_user ``arch/x86/kernel/apm_32.c``
CYCLADES_MAGIC 0x4359 cyclades_port ``include/linux/cyclades.h``
-DB_MAGIC 0x4442 fc_info ``drivers/net/iph5526_novram.c``
-DL_MAGIC 0x444d fc_info ``drivers/net/iph5526_novram.c``
FASYNC_MAGIC 0x4601 fasync_struct ``include/linux/fs.h``
-FF_MAGIC 0x4646 fc_info ``drivers/net/iph5526_novram.c``
ISICOM_MAGIC 0x4d54 isi_port ``include/linux/isicom.h``
-PTY_MAGIC 0x5001 ``drivers/char/pty.c``
-PPP_MAGIC 0x5002 ppp ``include/linux/if_pppvar.h``
-SSTATE_MAGIC 0x5302 serial_state ``include/linux/serial.h``
SLIP_MAGIC 0x5302 slip ``drivers/net/slip.h``
-STRIP_MAGIC 0x5303 strip ``drivers/net/strip.c``
X25_ASY_MAGIC 0x5303 x25_asy ``drivers/net/x25_asy.h``
-SIXPACK_MAGIC 0x5304 sixpack ``drivers/net/hamradio/6pack.h``
-AX25_MAGIC 0x5316 ax_disp ``drivers/net/mkiss.h``
TTY_MAGIC 0x5401 tty_struct ``include/linux/tty.h``
MGSL_MAGIC 0x5401 mgsl_info ``drivers/char/synclink.c``
TTY_DRIVER_MAGIC 0x5402 tty_driver ``include/linux/tty_driver.h``
MGSLPC_MAGIC 0x5402 mgslpc_info ``drivers/char/pcmcia/synclink_cs.c``
TTY_LDISC_MAGIC 0x5403 tty_ldisc ``include/linux/tty_ldisc.h``
-USB_SERIAL_MAGIC 0x6702 usb_serial ``drivers/usb/serial/usb-serial.h``
FULL_DUPLEX_MAGIC 0x6969 ``drivers/net/ethernet/dec/tulip/de2104x.c``
-USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth ``drivers/usb/class/bluetty.c``
RFCOMM_TTY_MAGIC 0x6d02 ``net/bluetooth/rfcomm/tty.c``
-USB_SERIAL_PORT_MAGIC 0x7301 usb_serial_port ``drivers/usb/serial/usb-serial.h``
CG_MAGIC 0x00090255 ufs_cylinder_group ``include/linux/ufs_fs.h``
RPORT_MAGIC 0x00525001 r_port ``drivers/char/rocket_int.h``
-LSEMAGIC 0x05091998 lse ``drivers/fc4/fc.c``
GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str ``drivers/scsi/gdth_ioctl.h``
RIEBL_MAGIC 0x09051990 ``drivers/net/atarilance.c``
NBD_REQUEST_MAGIC 0x12560953 nbd_request ``include/linux/nbd.h``
-RED_MAGIC2 0x170fc2a5 (any) ``mm/slab.c``
BAYCOM_MAGIC 0x19730510 baycom_state ``drivers/net/baycom_epp.c``
-ISDN_X25IFACE_MAGIC 0x1e75a2b9 isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h``
-ECP_MAGIC 0x21504345 cdkecpsig ``include/linux/cdk.h``
-LSOMAGIC 0x27091997 lso ``drivers/fc4/fc.c``
-LSMAGIC 0x2a3b4d2a ls ``drivers/fc4/fc.c``
-WANPIPE_MAGIC 0x414C4453 sdla_{dump,exec} ``include/linux/wanpipe.h``
-CS_CARD_MAGIC 0x43525553 cs_card ``sound/oss/cs46xx.c``
-LABELCL_MAGIC 0x4857434c labelcl_info_s ``include/asm/ia64/sn/labelcl.h``
-ISDN_ASYNC_MAGIC 0x49344C01 modem_info ``include/linux/isdn.h``
-CTC_ASYNC_MAGIC 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
-ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s ``drivers/isdn/i4l/isdn_net_lib.h``
SAVEKMSG_MAGIC2 0x4B4D5347 savekmsg ``arch/*/amiga/config.c``
-CS_STATE_MAGIC 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
-SLAB_C_MAGIC 0x4f17a36d kmem_cache ``mm/slab.c``
COW_MAGIC 0x4f4f4f4d cow_header_v1 ``arch/um/drivers/ubd_user.c``
-I810_CARD_MAGIC 0x5072696E i810_card ``sound/oss/i810_audio.c``
-TRIDENT_CARD_MAGIC 0x5072696E trident_card ``sound/oss/trident.c``
-ROUTER_MAGIC 0x524d4157 wan_device [in ``wanrouter.h`` pre 3.9]
SAVEKMSG_MAGIC1 0x53415645 savekmsg ``arch/*/amiga/config.c``
GDA_MAGIC 0x58464552 gda ``arch/mips/include/asm/sn/gda.h``
-RED_MAGIC1 0x5a2cf071 (any) ``mm/slab.c``
EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev ``drivers/atm/lanai.c``
HDLCDRV_MAGIC 0x5ac6e778 hdlcdrv_state ``include/linux/hdlcdrv.h``
-PCXX_MAGIC 0x5c6df104 channel ``drivers/char/pcxx.h``
KV_MAGIC 0x5f4b565f kernel_vars_s ``arch/mips/include/asm/sn/klkernvars.h``
-I810_STATE_MAGIC 0x63657373 i810_state ``sound/oss/i810_audio.c``
-TRIDENT_STATE_MAGIC 0x63657373 trient_state ``sound/oss/trident.c``
-M3_CARD_MAGIC 0x646e6f50 m3_card ``sound/oss/maestro3.c``
FW_HEADER_MAGIC 0x65726F66 fw_header ``drivers/atm/fore200e.h``
-SLOT_MAGIC 0x67267321 slot ``drivers/hotplug/cpqphp.h``
-SLOT_MAGIC 0x67267322 slot ``drivers/hotplug/acpiphp.h``
-LO_MAGIC 0x68797548 nbd_device ``include/linux/nbd.h``
-OPROFILE_MAGIC 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
-M3_STATE_MAGIC 0x734d724d m3_state ``sound/oss/maestro3.c``
-VMALLOC_MAGIC 0x87654320 snd_alloc_track ``sound/core/memory.c``
-KMALLOC_MAGIC 0x87654321 snd_alloc_track ``sound/core/memory.c``
-PWC_MAGIC 0x89DC10AB pwc_device ``drivers/usb/media/pwc.h``
NBD_REPLY_MAGIC 0x96744668 nbd_reply ``include/linux/nbd.h``
ENI155_MAGIC 0xa54b872d midway_eprom ``drivers/atm/eni.h``
CODA_MAGIC 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h``
@@ -138,7 +95,6 @@ YAM_MAGIC 0xF10A7654 yam_port ``drivers/net/ha
CCB_MAGIC 0xf2691ad2 ccb ``drivers/scsi/ncr53c8xx.c``
QUEUE_MAGIC_FREE 0xf7e1c9a3 queue_entry ``drivers/scsi/arm/queue.c``
QUEUE_MAGIC_USED 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
-HTB_CMAGIC 0xFEFAFEF1 htb_class ``net/sched/sch_htb.c``
NMI_MAGIC 0x48414d4d455201 nmi_s ``arch/mips/include/asm/sn/nmi.h``
===================== ================ ======================== ==========================================

--
2.24.0.432.g9d3f5f5b63-goog


2019-11-22 12:04:42

by Federico Vaga

[permalink] [raw]
Subject: Re: [PATCH] Delete obsolete magic constants from documentation

Acked-by: Federico Vaga <[email protected]>

On Thursday, November 21, 2019 8:15:36 PM CET Pascal Terjan wrote:
> Those no longer appear in the code.
> I have some more patches to cleanup some of them from the code but this
> is an easy first step.
>
> Signed-off-by: Pascal Terjan <[email protected]>
> ---
> Documentation/process/magic-number.rst | 44 -------------------
> .../it_IT/process/magic-number.rst | 44 -------------------
> .../zh_CN/process/magic-number.rst | 44 -------------------
> 3 files changed, 132 deletions(-)
>
> diff --git a/Documentation/process/magic-number.rst
> b/Documentation/process/magic-number.rst index eee9b44553b3..16f6a4a97c1e
> 100644
> --- a/Documentation/process/magic-number.rst
> +++ b/Documentation/process/magic-number.rst
> @@ -70,77 +70,34 @@ Magic Name Number Structure
> File ===================== ================ ========================
> ========================================== PG_MAGIC 'P'
> pg_{read,write}_hdr ``include/linux/pg.h`` CMAGIC
> 0x0111 user ``include/linux/a.out.h``
> -MKISS_DRIVER_MAGIC 0x04bf mkiss_channel
> ``drivers/net/mkiss.h`` HDLC_MAGIC 0x239e n_hdlc
> ``drivers/char/n_hdlc.c`` APM_BIOS_MAGIC 0x4101
> apm_user ``arch/x86/kernel/apm_32.c`` CYCLADES_MAGIC
> 0x4359 cyclades_port ``include/linux/cyclades.h``
> -DB_MAGIC 0x4442 fc_info
> ``drivers/net/iph5526_novram.c`` -DL_MAGIC 0x444d
> fc_info ``drivers/net/iph5526_novram.c`` FASYNC_MAGIC
> 0x4601 fasync_struct ``include/linux/fs.h``
> -FF_MAGIC 0x4646 fc_info
> ``drivers/net/iph5526_novram.c`` ISICOM_MAGIC 0x4d54
> isi_port ``include/linux/isicom.h`` -PTY_MAGIC
> 0x5001 ``drivers/char/pty.c`` -PPP_MAGIC
> 0x5002 ppp
> ``include/linux/if_pppvar.h`` -SSTATE_MAGIC 0x5302
> serial_state ``include/linux/serial.h`` SLIP_MAGIC
> 0x5302 slip ``drivers/net/slip.h``
> -STRIP_MAGIC 0x5303 strip
> ``drivers/net/strip.c`` X25_ASY_MAGIC 0x5303 x25_asy
> ``drivers/net/x25_asy.h`` -SIXPACK_MAGIC 0x5304
> sixpack ``drivers/net/hamradio/6pack.h`` -AX25_MAGIC
> 0x5316 ax_disp ``drivers/net/mkiss.h``
> TTY_MAGIC 0x5401 tty_struct
> ``include/linux/tty.h`` MGSL_MAGIC 0x5401 mgsl_info
> ``drivers/char/synclink.c`` TTY_DRIVER_MAGIC 0x5402
> tty_driver ``include/linux/tty_driver.h`` MGSLPC_MAGIC
> 0x5402 mgslpc_info
> ``drivers/char/pcmcia/synclink_cs.c`` TTY_LDISC_MAGIC 0x5403
> tty_ldisc ``include/linux/tty_ldisc.h`` -USB_SERIAL_MAGIC
> 0x6702 usb_serial
> ``drivers/usb/serial/usb-serial.h`` FULL_DUPLEX_MAGIC 0x6969
> ``drivers/net/ethernet/dec/tulip/de2104x.c``
> -USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth
> ``drivers/usb/class/bluetty.c`` RFCOMM_TTY_MAGIC 0x6d02
> ``net/bluetooth/rfcomm/tty.c`` -USB_SERIAL_PORT_MAGIC
> 0x7301 usb_serial_port
> ``drivers/usb/serial/usb-serial.h`` CG_MAGIC 0x00090255
> ufs_cylinder_group ``include/linux/ufs_fs.h`` RPORT_MAGIC
> 0x00525001 r_port ``drivers/char/rocket_int.h``
> -LSEMAGIC 0x05091998 lse
> ``drivers/fc4/fc.c`` GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str
> ``drivers/scsi/gdth_ioctl.h`` RIEBL_MAGIC 0x09051990
> ``drivers/net/atarilance.c`` NBD_REQUEST_MAGIC
> 0x12560953 nbd_request ``include/linux/nbd.h``
> -RED_MAGIC2 0x170fc2a5 (any)
> ``mm/slab.c`` BAYCOM_MAGIC 0x19730510 baycom_state
> ``drivers/net/baycom_epp.c`` -ISDN_X25IFACE_MAGIC 0x1e75a2b9
> isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h`` -ECP_MAGIC
> 0x21504345 cdkecpsig ``include/linux/cdk.h``
> -LSOMAGIC 0x27091997 lso
> ``drivers/fc4/fc.c`` -LSMAGIC 0x2a3b4d2a ls
> ``drivers/fc4/fc.c`` -WANPIPE_MAGIC 0x414C4453
> sdla_{dump,exec} ``include/linux/wanpipe.h`` -CS_CARD_MAGIC
> 0x43525553 cs_card ``sound/oss/cs46xx.c``
> -LABELCL_MAGIC 0x4857434c labelcl_info_s
> ``include/asm/ia64/sn/labelcl.h`` -ISDN_ASYNC_MAGIC 0x49344C01
> modem_info ``include/linux/isdn.h`` -CTC_ASYNC_MAGIC
> 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
> -ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s
> ``drivers/isdn/i4l/isdn_net_lib.h`` SAVEKMSG_MAGIC2 0x4B4D5347
> savekmsg ``arch/*/amiga/config.c`` -CS_STATE_MAGIC
> 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
> -SLAB_C_MAGIC 0x4f17a36d kmem_cache
> ``mm/slab.c`` COW_MAGIC 0x4f4f4f4d cow_header_v1
> ``arch/um/drivers/ubd_user.c`` -I810_CARD_MAGIC 0x5072696E
> i810_card ``sound/oss/i810_audio.c`` -TRIDENT_CARD_MAGIC
> 0x5072696E trident_card ``sound/oss/trident.c``
> -ROUTER_MAGIC 0x524d4157 wan_device [in
> ``wanrouter.h`` pre 3.9] SAVEKMSG_MAGIC1 0x53415645 savekmsg
> ``arch/*/amiga/config.c`` GDA_MAGIC 0x58464552
> gda ``arch/mips/include/asm/sn/gda.h`` -RED_MAGIC1
> 0x5a2cf071 (any) ``mm/slab.c``
> EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev
> ``drivers/atm/lanai.c`` HDLCDRV_MAGIC 0x5ac6e778
> hdlcdrv_state ``include/linux/hdlcdrv.h`` -PCXX_MAGIC
> 0x5c6df104 channel ``drivers/char/pcxx.h`` KV_MAGIC
> 0x5f4b565f kernel_vars_s
> ``arch/mips/include/asm/sn/klkernvars.h`` -I810_STATE_MAGIC 0x63657373
> i810_state ``sound/oss/i810_audio.c``
> -TRIDENT_STATE_MAGIC 0x63657373 trient_state
> ``sound/oss/trident.c`` -M3_CARD_MAGIC 0x646e6f50 m3_card
> ``sound/oss/maestro3.c`` FW_HEADER_MAGIC 0x65726F66
> fw_header ``drivers/atm/fore200e.h`` -SLOT_MAGIC
> 0x67267321 slot ``drivers/hotplug/cpqphp.h``
> -SLOT_MAGIC 0x67267322 slot
> ``drivers/hotplug/acpiphp.h`` -LO_MAGIC 0x68797548
> nbd_device ``include/linux/nbd.h`` -OPROFILE_MAGIC
> 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
> -M3_STATE_MAGIC 0x734d724d m3_state
> ``sound/oss/maestro3.c`` -VMALLOC_MAGIC 0x87654320
> snd_alloc_track ``sound/core/memory.c`` -KMALLOC_MAGIC
> 0x87654321 snd_alloc_track ``sound/core/memory.c``
> -PWC_MAGIC 0x89DC10AB pwc_device
> ``drivers/usb/media/pwc.h`` NBD_REPLY_MAGIC 0x96744668
> nbd_reply ``include/linux/nbd.h`` ENI155_MAGIC
> 0xa54b872d midway_eprom ``drivers/atm/eni.h`` CODA_MAGIC
> 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h`` @@
> -149,7 +106,6 @@ YAM_MAGIC 0xF10A7654 yam_port
> ``drivers/net/ha CCB_MAGIC 0xf2691ad2 ccb
> ``drivers/scsi/ncr53c8xx.c`` QUEUE_MAGIC_FREE 0xf7e1c9a3
> queue_entry ``drivers/scsi/arm/queue.c`` QUEUE_MAGIC_USED
> 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
> -HTB_CMAGIC 0xFEFAFEF1 htb_class
> ``net/sched/sch_htb.c`` NMI_MAGIC 0x48414d4d455201 nmi_s
> ``arch/mips/include/asm/sn/nmi.h`` =====================
> ================ ========================
> ==========================================
>
> diff --git a/Documentation/translations/it_IT/process/magic-number.rst
> b/Documentation/translations/it_IT/process/magic-number.rst index
> 783e0de314a0..823acaee8805 100644
> --- a/Documentation/translations/it_IT/process/magic-number.rst
> +++ b/Documentation/translations/it_IT/process/magic-number.rst
> @@ -76,77 +76,34 @@ Nome magico Numero Struttura
> File ===================== ================ ========================
> ========================================== PG_MAGIC 'P'
> pg_{read,write}_hdr ``include/linux/pg.h`` CMAGIC
> 0x0111 user ``include/linux/a.out.h``
> -MKISS_DRIVER_MAGIC 0x04bf mkiss_channel
> ``drivers/net/mkiss.h`` HDLC_MAGIC 0x239e n_hdlc
> ``drivers/char/n_hdlc.c`` APM_BIOS_MAGIC 0x4101
> apm_user ``arch/x86/kernel/apm_32.c`` CYCLADES_MAGIC
> 0x4359 cyclades_port ``include/linux/cyclades.h``
> -DB_MAGIC 0x4442 fc_info
> ``drivers/net/iph5526_novram.c`` -DL_MAGIC 0x444d
> fc_info ``drivers/net/iph5526_novram.c`` FASYNC_MAGIC
> 0x4601 fasync_struct ``include/linux/fs.h``
> -FF_MAGIC 0x4646 fc_info
> ``drivers/net/iph5526_novram.c`` ISICOM_MAGIC 0x4d54
> isi_port ``include/linux/isicom.h`` -PTY_MAGIC
> 0x5001 ``drivers/char/pty.c`` -PPP_MAGIC
> 0x5002 ppp
> ``include/linux/if_pppvar.h`` -SSTATE_MAGIC 0x5302
> serial_state ``include/linux/serial.h`` SLIP_MAGIC
> 0x5302 slip ``drivers/net/slip.h``
> -STRIP_MAGIC 0x5303 strip
> ``drivers/net/strip.c`` X25_ASY_MAGIC 0x5303 x25_asy
> ``drivers/net/x25_asy.h`` -SIXPACK_MAGIC 0x5304
> sixpack ``drivers/net/hamradio/6pack.h`` -AX25_MAGIC
> 0x5316 ax_disp ``drivers/net/mkiss.h``
> TTY_MAGIC 0x5401 tty_struct
> ``include/linux/tty.h`` MGSL_MAGIC 0x5401 mgsl_info
> ``drivers/char/synclink.c`` TTY_DRIVER_MAGIC 0x5402
> tty_driver ``include/linux/tty_driver.h`` MGSLPC_MAGIC
> 0x5402 mgslpc_info
> ``drivers/char/pcmcia/synclink_cs.c`` TTY_LDISC_MAGIC 0x5403
> tty_ldisc ``include/linux/tty_ldisc.h`` -USB_SERIAL_MAGIC
> 0x6702 usb_serial
> ``drivers/usb/serial/usb-serial.h`` FULL_DUPLEX_MAGIC 0x6969
> ``drivers/net/ethernet/dec/tulip/de2104x.c``
> -USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth
> ``drivers/usb/class/bluetty.c`` RFCOMM_TTY_MAGIC 0x6d02
> ``net/bluetooth/rfcomm/tty.c`` -USB_SERIAL_PORT_MAGIC
> 0x7301 usb_serial_port
> ``drivers/usb/serial/usb-serial.h`` CG_MAGIC 0x00090255
> ufs_cylinder_group ``include/linux/ufs_fs.h`` RPORT_MAGIC
> 0x00525001 r_port ``drivers/char/rocket_int.h``
> -LSEMAGIC 0x05091998 lse
> ``drivers/fc4/fc.c`` GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str
> ``drivers/scsi/gdth_ioctl.h`` RIEBL_MAGIC 0x09051990
> ``drivers/net/atarilance.c`` NBD_REQUEST_MAGIC
> 0x12560953 nbd_request ``include/linux/nbd.h``
> -RED_MAGIC2 0x170fc2a5 (any)
> ``mm/slab.c`` BAYCOM_MAGIC 0x19730510 baycom_state
> ``drivers/net/baycom_epp.c`` -ISDN_X25IFACE_MAGIC 0x1e75a2b9
> isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h`` -ECP_MAGIC
> 0x21504345 cdkecpsig ``include/linux/cdk.h``
> -LSOMAGIC 0x27091997 lso
> ``drivers/fc4/fc.c`` -LSMAGIC 0x2a3b4d2a ls
> ``drivers/fc4/fc.c`` -WANPIPE_MAGIC 0x414C4453
> sdla_{dump,exec} ``include/linux/wanpipe.h`` -CS_CARD_MAGIC
> 0x43525553 cs_card ``sound/oss/cs46xx.c``
> -LABELCL_MAGIC 0x4857434c labelcl_info_s
> ``include/asm/ia64/sn/labelcl.h`` -ISDN_ASYNC_MAGIC 0x49344C01
> modem_info ``include/linux/isdn.h`` -CTC_ASYNC_MAGIC
> 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
> -ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s
> ``drivers/isdn/i4l/isdn_net_lib.h`` SAVEKMSG_MAGIC2 0x4B4D5347
> savekmsg ``arch/*/amiga/config.c`` -CS_STATE_MAGIC
> 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
> -SLAB_C_MAGIC 0x4f17a36d kmem_cache
> ``mm/slab.c`` COW_MAGIC 0x4f4f4f4d cow_header_v1
> ``arch/um/drivers/ubd_user.c`` -I810_CARD_MAGIC 0x5072696E
> i810_card ``sound/oss/i810_audio.c`` -TRIDENT_CARD_MAGIC
> 0x5072696E trident_card ``sound/oss/trident.c``
> -ROUTER_MAGIC 0x524d4157 wan_device [in
> ``wanrouter.h`` pre 3.9] SAVEKMSG_MAGIC1 0x53415645 savekmsg
> ``arch/*/amiga/config.c`` GDA_MAGIC 0x58464552
> gda ``arch/mips/include/asm/sn/gda.h`` -RED_MAGIC1
> 0x5a2cf071 (any) ``mm/slab.c``
> EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev
> ``drivers/atm/lanai.c`` HDLCDRV_MAGIC 0x5ac6e778
> hdlcdrv_state ``include/linux/hdlcdrv.h`` -PCXX_MAGIC
> 0x5c6df104 channel ``drivers/char/pcxx.h`` KV_MAGIC
> 0x5f4b565f kernel_vars_s
> ``arch/mips/include/asm/sn/klkernvars.h`` -I810_STATE_MAGIC 0x63657373
> i810_state ``sound/oss/i810_audio.c``
> -TRIDENT_STATE_MAGIC 0x63657373 trient_state
> ``sound/oss/trident.c`` -M3_CARD_MAGIC 0x646e6f50 m3_card
> ``sound/oss/maestro3.c`` FW_HEADER_MAGIC 0x65726F66
> fw_header ``drivers/atm/fore200e.h`` -SLOT_MAGIC
> 0x67267321 slot ``drivers/hotplug/cpqphp.h``
> -SLOT_MAGIC 0x67267322 slot
> ``drivers/hotplug/acpiphp.h`` -LO_MAGIC 0x68797548
> nbd_device ``include/linux/nbd.h`` -OPROFILE_MAGIC
> 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
> -M3_STATE_MAGIC 0x734d724d m3_state
> ``sound/oss/maestro3.c`` -VMALLOC_MAGIC 0x87654320
> snd_alloc_track ``sound/core/memory.c`` -KMALLOC_MAGIC
> 0x87654321 snd_alloc_track ``sound/core/memory.c``
> -PWC_MAGIC 0x89DC10AB pwc_device
> ``drivers/usb/media/pwc.h`` NBD_REPLY_MAGIC 0x96744668
> nbd_reply ``include/linux/nbd.h`` ENI155_MAGIC
> 0xa54b872d midway_eprom ``drivers/atm/eni.h`` CODA_MAGIC
> 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h`` @@
> -155,7 +112,6 @@ YAM_MAGIC 0xF10A7654 yam_port
> ``drivers/net/ha CCB_MAGIC 0xf2691ad2 ccb
> ``drivers/scsi/ncr53c8xx.c`` QUEUE_MAGIC_FREE 0xf7e1c9a3
> queue_entry ``drivers/scsi/arm/queue.c`` QUEUE_MAGIC_USED
> 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
> -HTB_CMAGIC 0xFEFAFEF1 htb_class
> ``net/sched/sch_htb.c`` NMI_MAGIC 0x48414d4d455201 nmi_s
> ``arch/mips/include/asm/sn/nmi.h`` =====================
> ================ ========================
> ==========================================
>
> diff --git a/Documentation/translations/zh_CN/process/magic-number.rst
> b/Documentation/translations/zh_CN/process/magic-number.rst index
> e4c225996af0..31669c1cfaa6 100644
> --- a/Documentation/translations/zh_CN/process/magic-number.rst
> +++ b/Documentation/translations/zh_CN/process/magic-number.rst
> @@ -59,77 +59,34 @@ Linux 魔术数
> ===================== ================ ========================
> ========================================== PG_MAGIC 'P'
> pg_{read,write}_hdr ``include/linux/pg.h`` CMAGIC
> 0x0111 user ``include/linux/a.out.h``
> -MKISS_DRIVER_MAGIC 0x04bf mkiss_channel
> ``drivers/net/mkiss.h`` HDLC_MAGIC 0x239e n_hdlc
> ``drivers/char/n_hdlc.c`` APM_BIOS_MAGIC 0x4101
> apm_user ``arch/x86/kernel/apm_32.c`` CYCLADES_MAGIC
> 0x4359 cyclades_port ``include/linux/cyclades.h``
> -DB_MAGIC 0x4442 fc_info
> ``drivers/net/iph5526_novram.c`` -DL_MAGIC 0x444d
> fc_info ``drivers/net/iph5526_novram.c`` FASYNC_MAGIC
> 0x4601 fasync_struct ``include/linux/fs.h``
> -FF_MAGIC 0x4646 fc_info
> ``drivers/net/iph5526_novram.c`` ISICOM_MAGIC 0x4d54
> isi_port ``include/linux/isicom.h`` -PTY_MAGIC
> 0x5001 ``drivers/char/pty.c`` -PPP_MAGIC
> 0x5002 ppp
> ``include/linux/if_pppvar.h`` -SSTATE_MAGIC 0x5302
> serial_state ``include/linux/serial.h`` SLIP_MAGIC
> 0x5302 slip ``drivers/net/slip.h``
> -STRIP_MAGIC 0x5303 strip
> ``drivers/net/strip.c`` X25_ASY_MAGIC 0x5303 x25_asy
> ``drivers/net/x25_asy.h`` -SIXPACK_MAGIC 0x5304
> sixpack ``drivers/net/hamradio/6pack.h`` -AX25_MAGIC
> 0x5316 ax_disp ``drivers/net/mkiss.h``
> TTY_MAGIC 0x5401 tty_struct
> ``include/linux/tty.h`` MGSL_MAGIC 0x5401 mgsl_info
> ``drivers/char/synclink.c`` TTY_DRIVER_MAGIC 0x5402
> tty_driver ``include/linux/tty_driver.h`` MGSLPC_MAGIC
> 0x5402 mgslpc_info
> ``drivers/char/pcmcia/synclink_cs.c`` TTY_LDISC_MAGIC 0x5403
> tty_ldisc ``include/linux/tty_ldisc.h`` -USB_SERIAL_MAGIC
> 0x6702 usb_serial
> ``drivers/usb/serial/usb-serial.h`` FULL_DUPLEX_MAGIC 0x6969
> ``drivers/net/ethernet/dec/tulip/de2104x.c``
> -USB_BLUETOOTH_MAGIC 0x6d02 usb_bluetooth
> ``drivers/usb/class/bluetty.c`` RFCOMM_TTY_MAGIC 0x6d02
> ``net/bluetooth/rfcomm/tty.c`` -USB_SERIAL_PORT_MAGIC
> 0x7301 usb_serial_port
> ``drivers/usb/serial/usb-serial.h`` CG_MAGIC 0x00090255
> ufs_cylinder_group ``include/linux/ufs_fs.h`` RPORT_MAGIC
> 0x00525001 r_port ``drivers/char/rocket_int.h``
> -LSEMAGIC 0x05091998 lse
> ``drivers/fc4/fc.c`` GDTIOCTL_MAGIC 0x06030f07 gdth_iowr_str
> ``drivers/scsi/gdth_ioctl.h`` RIEBL_MAGIC 0x09051990
> ``drivers/net/atarilance.c`` NBD_REQUEST_MAGIC
> 0x12560953 nbd_request ``include/linux/nbd.h``
> -RED_MAGIC2 0x170fc2a5 (any)
> ``mm/slab.c`` BAYCOM_MAGIC 0x19730510 baycom_state
> ``drivers/net/baycom_epp.c`` -ISDN_X25IFACE_MAGIC 0x1e75a2b9
> isdn_x25iface_proto_data ``drivers/isdn/isdn_x25iface.h`` -ECP_MAGIC
> 0x21504345 cdkecpsig ``include/linux/cdk.h``
> -LSOMAGIC 0x27091997 lso
> ``drivers/fc4/fc.c`` -LSMAGIC 0x2a3b4d2a ls
> ``drivers/fc4/fc.c`` -WANPIPE_MAGIC 0x414C4453
> sdla_{dump,exec} ``include/linux/wanpipe.h`` -CS_CARD_MAGIC
> 0x43525553 cs_card ``sound/oss/cs46xx.c``
> -LABELCL_MAGIC 0x4857434c labelcl_info_s
> ``include/asm/ia64/sn/labelcl.h`` -ISDN_ASYNC_MAGIC 0x49344C01
> modem_info ``include/linux/isdn.h`` -CTC_ASYNC_MAGIC
> 0x49344C01 ctc_tty_info ``drivers/s390/net/ctctty.c``
> -ISDN_NET_MAGIC 0x49344C02 isdn_net_local_s
> ``drivers/isdn/i4l/isdn_net_lib.h`` SAVEKMSG_MAGIC2 0x4B4D5347
> savekmsg ``arch/*/amiga/config.c`` -CS_STATE_MAGIC
> 0x4c4f4749 cs_state ``sound/oss/cs46xx.c``
> -SLAB_C_MAGIC 0x4f17a36d kmem_cache
> ``mm/slab.c`` COW_MAGIC 0x4f4f4f4d cow_header_v1
> ``arch/um/drivers/ubd_user.c`` -I810_CARD_MAGIC 0x5072696E
> i810_card ``sound/oss/i810_audio.c`` -TRIDENT_CARD_MAGIC
> 0x5072696E trident_card ``sound/oss/trident.c``
> -ROUTER_MAGIC 0x524d4157 wan_device [in
> ``wanrouter.h`` pre 3.9] SAVEKMSG_MAGIC1 0x53415645 savekmsg
> ``arch/*/amiga/config.c`` GDA_MAGIC 0x58464552
> gda ``arch/mips/include/asm/sn/gda.h`` -RED_MAGIC1
> 0x5a2cf071 (any) ``mm/slab.c``
> EEPROM_MAGIC_VALUE 0x5ab478d2 lanai_dev
> ``drivers/atm/lanai.c`` HDLCDRV_MAGIC 0x5ac6e778
> hdlcdrv_state ``include/linux/hdlcdrv.h`` -PCXX_MAGIC
> 0x5c6df104 channel ``drivers/char/pcxx.h`` KV_MAGIC
> 0x5f4b565f kernel_vars_s
> ``arch/mips/include/asm/sn/klkernvars.h`` -I810_STATE_MAGIC 0x63657373
> i810_state ``sound/oss/i810_audio.c``
> -TRIDENT_STATE_MAGIC 0x63657373 trient_state
> ``sound/oss/trident.c`` -M3_CARD_MAGIC 0x646e6f50 m3_card
> ``sound/oss/maestro3.c`` FW_HEADER_MAGIC 0x65726F66
> fw_header ``drivers/atm/fore200e.h`` -SLOT_MAGIC
> 0x67267321 slot ``drivers/hotplug/cpqphp.h``
> -SLOT_MAGIC 0x67267322 slot
> ``drivers/hotplug/acpiphp.h`` -LO_MAGIC 0x68797548
> nbd_device ``include/linux/nbd.h`` -OPROFILE_MAGIC
> 0x6f70726f super_block ``drivers/oprofile/oprofilefs.h``
> -M3_STATE_MAGIC 0x734d724d m3_state
> ``sound/oss/maestro3.c`` -VMALLOC_MAGIC 0x87654320
> snd_alloc_track ``sound/core/memory.c`` -KMALLOC_MAGIC
> 0x87654321 snd_alloc_track ``sound/core/memory.c``
> -PWC_MAGIC 0x89DC10AB pwc_device
> ``drivers/usb/media/pwc.h`` NBD_REPLY_MAGIC 0x96744668
> nbd_reply ``include/linux/nbd.h`` ENI155_MAGIC
> 0xa54b872d midway_eprom ``drivers/atm/eni.h`` CODA_MAGIC
> 0xC0DAC0DA coda_file_info ``fs/coda/coda_fs_i.h`` @@
> -138,7 +95,6 @@ YAM_MAGIC 0xF10A7654 yam_port
> ``drivers/net/ha CCB_MAGIC 0xf2691ad2 ccb
> ``drivers/scsi/ncr53c8xx.c`` QUEUE_MAGIC_FREE 0xf7e1c9a3
> queue_entry ``drivers/scsi/arm/queue.c`` QUEUE_MAGIC_USED
> 0xf7e1cc33 queue_entry ``drivers/scsi/arm/queue.c``
> -HTB_CMAGIC 0xFEFAFEF1 htb_class
> ``net/sched/sch_htb.c`` NMI_MAGIC 0x48414d4d455201 nmi_s
> ``arch/mips/include/asm/sn/nmi.h`` =====================
> ================ ========================
> ==========================================




2019-11-22 17:10:29

by Jonathan Corbet

[permalink] [raw]
Subject: Re: [PATCH] Delete obsolete magic constants from documentation

On Thu, 21 Nov 2019 19:15:36 +0000
Pascal Terjan <[email protected]> wrote:

> Those no longer appear in the code.
> I have some more patches to cleanup some of them from the code but this
> is an easy first step.
>
> Signed-off-by: Pascal Terjan <[email protected]>
> ---
> Documentation/process/magic-number.rst | 44 -------------------
> .../it_IT/process/magic-number.rst | 44 -------------------
> .../zh_CN/process/magic-number.rst | 44 -------------------
> 3 files changed, 132 deletions(-)

So I absolutely love this patch; we really need to clean this kind of
cruft out of the docs.

Unfortunately, it doesn't apply to docs-next; did you prepare it against
linux-next, perhaps? Is there any chance I could get a version against
docs-next?

If you're up for further work on this file, it would be nice to get rid of
the 2.x "changelog" text at the beginning; I don't think that has any real
value now.

Thanks,

jon

2019-11-23 16:53:04

by Pascal Terjan

[permalink] [raw]
Subject: Re: [PATCH] Delete obsolete magic constants from documentation

On Fri, 22 Nov 2019 at 17:08, Jonathan Corbet <[email protected]> wrote:
>
> On Thu, 21 Nov 2019 19:15:36 +0000
> Pascal Terjan <[email protected]> wrote:
>
> > Those no longer appear in the code.
> > I have some more patches to cleanup some of them from the code but this
> > is an easy first step.
> >
> > Signed-off-by: Pascal Terjan <[email protected]>
> > ---
> > Documentation/process/magic-number.rst | 44 -------------------
> > .../it_IT/process/magic-number.rst | 44 -------------------
> > .../zh_CN/process/magic-number.rst | 44 -------------------
> > 3 files changed, 132 deletions(-)
>
> So I absolutely love this patch; we really need to clean this kind of
> cruft out of the docs.
>
> Unfortunately, it doesn't apply to docs-next; did you prepare it against
> linux-next, perhaps? Is there any chance I could get a version against
> docs-next?

Right, that probably because of the lack of my previous patch
https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?id=fba67e8f897870403e1a4f5fe3835c870cd589e0
which hasn't finished its journey yet

I am not sure how to proceed as there are a few other patches for
various subsystems I am planning to send out (like deleting
RFCOMM_TTY_MAGIC from net/bluetooth/rfcomm/tty.c or GDTIOCTL_MAGIC
from drivers/scsi/gdth_ioctl.h) which will also be touching this file
and I'd rather not cause some merge problems...
Maybe I should not update the documentation in the patches removing
the constants from the code and clean it up separately?

> If you're up for further work on this file, it would be nice to get rid of
> the 2.x "changelog" text at the beginning; I don't think that has any real
> value now.

Sure, I picked this file and initially started cleaning it up,
including deleting that changelog, but then decided to first clean up
the code referencing some of those constants without using them.
There are lots of other things to delete in this file, like references
to OSS and maybe even the file itself given that the practice of using
a magic field in structs is no longer common, but I can start sending
a few simple cleanups.

> Thanks,
>
> jon