Annotation of driverkit/doc/OLD_NRW/API_Change_log, revision 1.1.1.1

1.1       root        1: Changes to driverkit API, 21 Jan 93.
                      2: 
                      3: Renamed symbols are described in the form
                      4: 
                      5:        old_symbol_name ==> new_symbol_name
                      6:        
                      7: * user_driver.h
                      8: changed file name to driverServer.h. No longer public.
                      9: IOGetDeviceType() ==> _IOLookupByDeviceNumber()
                     10: IOGetDeviceTypeFromPort ==> _IOLookupByDevicePort
                     11: IOPhysDevicePage() ==> _IOGetPhysicalAddressOfDevicePage()
                     12:        devicePage arg was vm_offset_t *, is unsigned *
                     13: IOMapSlot ==> _IOMapSlotSpace
                     14: IOUnmapSlot ==> _IOUnmapSlotSpace
                     15: IOMapBoard ==> _IOMapBoardSpace
                     16: IOUnmapBoard ==> _IOUnmapBoardSpace
                     17: all constants moved to driverServerTypes.h
                     18: IO_CC_INTR_ENABLE ==> IO_CC_ENABLE_INTERRUPTS
                     19: IO_CC_INTR_DISABLE ==> IO_CC_DISABLE_INTERRUPTS
                     20: IO_CC_LOOP_FRAME ==> IO_CC_CONNECT_FRAME_LOOP
                     21: IO_CC_UNLOOP_FRAME ==> IO_CC_DISCONNECT_FRAME_LOOP
                     22: IO_CC_DEV_INTR_ENABLE ==> IO_CC_ENABLE_INTERRUPTS_DEVICE
                     23: IO_CC_DEV_INTR_DISABLE ==> IO_CC_DISABLE_INTERRUPTS_DEVICE
                     24: IOEnqueueDma() ==> _IOEnqueueDMA()
                     25: IO_CEO_EOR ==> IO_CEO_END_OF_RECORD
                     26: IO_CEO_DESC_INTR ==> IO_CEO_DESCRIPTOR_INTERRUPT
                     27: IO_CEO_ENABLE_INTR ==> IO_CEO_ENABLE_INTERRUPTS
                     28: IO_CEO_ENABLE_CHAN ==> IO_CEO_ENABLE_CHANNEL
                     29: IO_CEO_DESC_CMD ==> IO_CEO_DESCRIPTOR_COMMAND
                     30: IODequeueDma() ==> _IODequeueDMA()
                     31: IO_CDO_ENABLE_INTR ==> IO_CDO_ENABLE_INTERRUPTS
                     32: IO_CDO_EI_IF_MT ==> IO_CDO_ENABLE_INTERRUPTS_IF_EMPTY
                     33: DMA_ID_NULL ==> IO_NULL_DMA_ID
                     34: IOInquire() ==? _IOLookupByObjectNumber()
                     35: IOLookup() ==> _IOLookupByDeviceName()
                     36: IOGetParameterInt() ==> _IOGetIntValues()
                     37: IOGetParameterChar() ==> _IOGetCharValues()
                     38: IOSetParameterInt() ==> _IOSetIntValues()
                     39: IOSetParameterChar() ==> _IOSetCharValues()
                     40: IO_CHAN_NONE ==> IO_NO_CHANNEL
                     41: IOCreateDevicePort ==> _IOCreateDevicePort
                     42: IODestroyDevicePort ==> _IODestroyDevicePort
                     43: IOAttachInterrupt ==> _IOAttachInterrupt
                     44: IODetachInterrupt ==> _IODetachInterrupt
                     45: IOAttachChannel ==> _IOAttachChannel
                     46: IODetachChannel ==> _IODetachChannel
                     47: IOMapDevicePage ==> _IOMapDevicePage
                     48: IOUnmapDevicePage ==> _IOUnmapDevicePage
                     49: IOSendChannelCommand ==> _IOSendChannelCommand
                     50: 
                     51: * user_driver_types.h
                     52: changed file name to driverTypes.h.
                     53: #imported <objc/objc.h>. If used in a .c files, -ObjC must be specified.
                     54: Deleted IODeviceReturn type. These return types have been added to 
                     55:    IOReturn.
                     56: deleted IODevRtn.
                     57: moved IODevicePort to driverTypesPrivate, used only by mig and its spawn.
                     58: IO_DR_SUCCESS ==> IO_R_SUCCESS
                     59: IO_DR_ACCESS ==> IO_R_PRIVILEGE
                     60: IO_DR_NOTATTACHED ==> IO_R_NOTATTACHED
                     61: IO_DR_INVALID ==> IO_R_INVALIDARG
                     62: IO_DR_MEMORY ==> IO_R_PRIVILEGE
                     63: IO_DR_NOCHANNEL ==> IO_R_NO_CHANNELS
                     64: IO_DR_NOSPACE ==> IO_R_NO_SPACE
                     65: IO_DR_NODEVICES ==> IO_R_NODEVICES
                     66: IO_DR_NOPORT ==> IO_R_RESOURCE
                     67: IO_DR_MAXCHANNELS ==> IO_R_INVALIDARG
                     68: IO_DR_EXISTS ==> IO_R_EXISTS
                     69: IO_DR_NOINTR ==> IO_R_RESOURCE
                     70: IO_DR_BUSY ==> IO_R_BUSY
                     71: IO_DR_UNSUPPORTED ==> IO_R_UNSUPPORTED
                     72: IO_DR_ALIGNMENT ==> IO_R_ALIGN
                     73: IO_DR_CANTWIRE ==> IO_R_CANTWIRE
                     74: IO_DR_NOINTERRUPT ==> IO_R_NOINTERRUPT
                     75: IO_DR_RESOURCE ==> IO_R_RESOURCE
                     76: IO_DR_NOFRAMES ==> IO_R_NOFRAMES
                     77: IO_DR_INTERNAL ==> IO_R_INTERNAL
                     78: IOUnitNumber-->IOObjectNumber
                     79: added IO_STRING_LENGTH
                     80: added IOString
                     81: deleted IOUnitName
                     82: deleted IOUnitType
                     83: deleted UNITNAME_LENGTH
                     84: deleted UNITTYPE_LENGTH
                     85: IO_DS_NONE ==> IO_None
                     86: IO_DS_COMPLETE ==> IO_Complete
                     87: IO_DS_RUNNING ==> IO_Running
                     88: IO_DS_UNDERRUN ==> IO_Underrun
                     89: IO_DS_BUSERR ==> IO_BusError
                     90: IO_DS_BUFERR ==> IO_BufferError
                     91: IO_DMA_DIR_READ ==> IO_DMARead
                     92: IO_DMA_DIR_WRITE ==> IO_DMAWrite
                     93: DEV_CACHE_OFF ==> IO_CacheOff
                     94: DEV_CACHE_WRITE_THRU ==> IO_WriteThrough
                     95: DEV_CACHE_COPY_BACK ==> IO_CopyBack
                     96: DEV_TASK_NULL ==> IO_NULL_VM_TASK
                     97: NATIVE_SLOT_ID ==> IO_NATIVE_SLOT_ID
                     98: DEV_TYPE_SLOT ==> IO_SLOT_DEVICE_TYPE
                     99: SLOT_ID_NULL ==> IO_NULL_SLOT_ID
                    100: DEV_TYPE_NULL ==> IO_NULL_DEVICE_TYPE
                    101: DEV_INDEX_NULL ==> IO_NULL_DEVICE_INDEX
                    102: BOARD_SIZE_MAX ==> IO_MAX_BOARD_SIZE
                    103: SLOT_SIZE_NRW_MAX ==> IO_MAX_NRW_SLOT_SIZE
                    104: SLOT_SIZE_MAX ==> IO_MAX_SLOT_SIZE
                    105: IO_PARAMETER_NAME_SIZE ==> IO_MAX_PARAMETER_NAME_LENGTH
                    106: IO_MAX_PARAMETER_ARRAY ==> IO_MAX_PARAMETER_ARRAY_LENGTH
                    107: dmaStatValues ==> IODMAStatusStrings
                    108: rvValue ==> value
                    109: rvName ==> name
                    110: regValues ==> IONamedValue
                    111: added IODeviceStyle
                    112: IOCacheSpec ==> IOCache
                    113: IODmaDirection ==> IODMADirection
                    114: IODmaStatus ==> IODMAStatus
                    115: 
                    116: *deviceCommon.h
                    117: renamed file to return.h.
                    118: Moved everything except typedef for IOReturn and IO_R_xxxx to 
                    119:        driverServerTypes.h.
                    120: IO_R_BADMSGID ==> IO_R_BAD_MSG_ID
                    121: IO_R_EXCL_ACCESS ==> IO_R_EXCLUSIVE_ACCESS
                    122: IO_R_INVALIDARG ==> IO_R_INVALID_ARG
                    123: IO_R_IPCFAIL ==> IO_R_IPC_FAILURE
                    124: IO_R_NODEVICE ==> IO_R_NO_DEVICE
                    125: IO_R_NOMEM ==> IO_R_NO_MEMORY
                    126: IO_R_NOTOPEN ==> IO_R_NOT_OPEN
                    127: IO_R_NOTREADABLE ==> IO_R_NOT_READABLE
                    128: IO_R_NOTREADY ==> IO_R_NOT_READY
                    129: IO_R_NOTWRITEABLE ==> IO_R_NOT_WRITABLE
                    130: IO_R_VMEMFAIL ==> IO_R_VM_FAILURE
                    131: 
                    132: * uxpr.h
                    133: Renamed file to debugging.h
                    134: XPR_DEBUG ==> DDM_DEBUG
                    135: NUM_XPR_MASKS ==> IO_NUM_DDM_MASKS
                    136: xprMask ==> IODDMMasks
                    137: xprInit() ==> IOInitDDM()
                    138: xprAdd() ==> IOAddDDMEntry()
                    139: xprClear() ==> IOClearDDM()
                    140: xprGetBitmask() ==> IOGetDDMMask()
                    141: xprSetBitmask() ==> IOSetDDMMask()
                    142: xprGetEntry() ==> IOGetDDMEntry()
                    143: xpr_string() ==> IOCopyString()
                    144: uxpr() ==> IODEBUG()
                    145: 
                    146: * uxprServer.h
                    147: Renamed file to debuggingMsg.h
                    148: SIZEOF_EXPORTED_STRING ==> IO_DDM_STRING_LENGTH
                    149: arg_type ==> argType
                    150: mask_value ==> maskValue
                    151: timestamp_hi ==> timestampHighInt
                    152: timestamp_low ==> timestampLowInt
                    153: cpu_num ==> cpuNumber
                    154: string_type ==> stringType
                    155: uxprMessage_t ==> IODDMMsg
                    156: UXPR_MSG_BASE ==> IO_DDM_MSG_BASE
                    157: UXPR_MSG_LOCK ==> IO_LOCK_DDM_MSG
                    158: UXPR_MSG_UNLOCK ==> IO_UNLOCK_DDM_MSG
                    159: UXPR_MSG_GETSTRING ==> IO_GET_DDM_ENTRY_MSG
                    160: UXPR_MSG_SETMASK ==> IO_SET_DDM_MASK_MSG
                    161: UXPR_MSG_CLEAR ==> IO_CLEAR_DDM_MSG
                    162: XPR_STATUS_GOOD ==> IO_DDM_SUCCESS
                    163: XPR_STATUS_NOBUF ==> IO_NO_DDM_BUFFER
                    164: XPR_STATUS_BADINDEX ==> IO_BAD_DDM_INDEX
                    165: uxpr_ns_time() ==> IONsTimeFromDDMMsg()
                    166: 
                    167: * libIO.h
                    168: Renamed file to generalFuncs.h
                    169: IOThreadFcn ==> IOThreadFunc 
                    170: IOTimeout() ==> IOScheduleFunc()
                    171: IOUntimeout() ==> IOUnscheduleFunc()
                    172: IOTimeStamp() ==> IOGetTimestamp()
                    173: deleted IOTaskSelf()
                    174: IOVmTaskSelf - made #ifdef KERNEL.
                    175: IOIntToString() ==> IOFindNameForValue()
                    176: IOStringToInt() ==> IOFindValueForName()
                    177: IOlibIOInit ==> IOInitGeneralFuncs()
                    178: 
                    179: * interrupt_msg.h
                    180: Renamed file to interruptMsg.h
                    181: interruptMsg_t ==> IOInterruptMsg
                    182: INT_MSG_ID_BASE ==> IO_INTERRUPT_MSG_ID_BASE
                    183: INT_MSG_TIMEOUT ==> IO_TIMEOUT_MSG
                    184: INT_MSG_COMMAND ==>  IO_COMMAND_MSG
                    185: INT_MSG_DEVICE ==> IO_DEVICE_INTERRUPT_MSG
                    186: INT_MSG_DMA ==> IO_DMA_INTERRUPT_MSG
                    187: 
                    188: * IOAlign.h 
                    189: Renamed file to align.h
                    190: DMA_DO_ALIGN() ==> IOAlign()
                    191: DMA_ISALIGNED() ==> IOIsAligned()
                    192: deleted _is_page_aligned()
                    193: deleted _round_int()
                    194: 
                    195: * IODevice.h
                    196: _deviceName, _deviceType, _location now are all type IOString
                    197: added -initFromDeviceDescription:
                    198: changed probe: syntax
                    199: added +deviceStyle
                    200: deleted -registerSelf
                    201: setDeviceName ==> setName
                    202: deviceName ==> name
                    203: _deviceType ==> _deviceKind (not in sed script)
                    204: -deviceType ==> -deviceKind
                    205: -setDeviceType ==> -setDeviceKind
                    206: IO_Class_Name ==> IOClassName
                    207: IO_Device_Name ==> IODeviceName
                    208: IO_Device_Type ==> IODeviceType
                    209: IOReturnToString ==> stringFromReturn
                    210: IOReturnToErrno ==> errnoFromReturn
                    211: all get/set parameter methods com[letely changed syntax.
                    212: 
                    213: * IOTsval.h - deleted.
                    214: 
                    215: * kern_driver.h
                    216: Renamed file to kernelDriver.h.
                    217: Moved IOEnqueueDmaInt() to driverServer.h (private).
                    218: IOEnqueueDmaInt() ==> _IOEnqueueDMAInt()
                    219: deleted IOKernPhysDevicePage()
                    220: IOKernDeviceLookup() ==> IOGetObjectForDeviceName()
                    221: IO_CC_DISABLE_UXPR ==> IO_CC_DISABLE_DDM, moved to kernelDriverPrivate.h
                    222: IO_CC_ENABLE_UXPR ==> IO_CC_ENABLE_DDM, moved to kernelDriverPrivate.h
                    223: IOTaskGetPort(), IOGetKernPort(), convertPortToIOTask() all replaced by
                    224:        IOConvertPort().
                    225: 
                    226: * IODeviceParams.h 
                    227: completely rewrote, replaced with ObjC methods as category GlobalParameter 
                    228:        of IODevice.
                    229: 
                    230: * IODiskDevice
                    231: Renamed file to IODisk.h
                    232: IODiskDevice ==> IODisk
                    233: IODevToIdMap ==> IODevAndIdInfo
                    234: IO_RS_READY ==> IO_Ready
                    235: IO_RS_NOTREADY ==> IO_NotReady
                    236: IO_RS_NODISK ==> IO_NoDisk
                    237: IO_RS_EJECTING ==> IO_Ejecting
                    238: _logicalDisk ==> _nextLogicalDisk
                    239: _isPhysDevice ==> _isPhysical
                    240: _removable, _formatted, _isPhysical, _writeProtected are all BOOL
                    241: _deviceSize ==> _diskSize
                    242: setDeviceSize ==> setDiskSize
                    243: deviceSize ==> diskSize
                    244: setIsPhysDevice ==> setIsPhysical
                    245: isPhysFlag ==> isPhysical
                    246: -formatted ==> isFormatted (not in sed)
                    247: -removable ==> -isRemovable (not in sed)
                    248: -isPhysDevice ==> -isPhysical
                    249: -writeProtected ==> -isWriteProtected (not in sed)
                    250: ejectDisk ==> eject
                    251: setFormattedInt ==> setFormattedInternal
                    252: readStats ==> addToBytesRead
                    253: writeStats ==> addToBytesWritten
                    254: didReadRetry ==> incrementReadRetries
                    255: gotReadError ==> incrementReadErrors
                    256: didWriteRetry ==> incrementWriteRetries
                    257: gotWriteError ==> incrementWriteErrors
                    258: didOtherRetry ==> incrementOtherRetries
                    259: gotOtherError ==> incrementOtherErrors
                    260: IO_DISK_STATISTICS ==> IO_DISK_STATS
                    261: IO_ISA_DISK ==> IO_IS_A_DISK
                    262: IO_Disk_Statistics ==> IODiskStats
                    263: IO_isa_Disk ==> IOIsADisk
                    264: IO_IS A_PHYSDEVICE ==> IO_IS_A_PHYSICAL_DISK
                    265: IO_isa_physDevice ==> IOIsAPhysicalDisk
                    266: DISK_STATS_READ_OPS ==> IO_Reads
                    267: DISK_STATS_BYTES_READ ==> IO_BytesRead
                    268: DISK_STATS_READ_TOTAL_TIME ==> IO_TotalReadTime
                    269: DISK_STATS_READ_LATENT_TIME ==> IO_LatentReadTime
                    270: DISK_STATS_READ_RETRIES ==> IO_ReadRetries
                    271: DISK_STATS_READ_ERRORS ==> IO_ReadErrors
                    272: DISK_STATS_WRITE_OPS ==> IO_Writes
                    273: DISK_STATS_BYTES_WRITTEN ==> IO_BytesWritten
                    274: DISK_STATS_WRITE_TOTAL_TIME ==> IO_TotalWriteTime
                    275: DISK_STATS_WRITE_LATENT_TIME ==> IO_LatentWriteTime
                    276: DISK_STATS_WRITE_RETRIES ==> IO_WriteRetries
                    277: DISK_STATS_WRITE_ERRORS ==> IO_WriteErrors
                    278: DISK_STATS_OTHER_RETRIES ==> IO_OtherRetries
                    279: DISK_STATS_OTHER_ERRORS ==> IO_OtherErrors
                    280: deleted -registerDisk
                    281: registerLogicalDisk ==> setLogicalDisk
                    282: lockLogical ==> lockLogicalDisks
                    283: unlockLogical ==> unlockLogicalDisks
                    284: DiskDeviceSubclass ==> IOPhysicalDiskMethods
                    285: getPhysParams ==> updatePhysicalParameters
                    286: -isDiskPresent ==> isDiskReady
                    287: devEjectDisk ==> ejectPhysical
                    288: checkReady ==> updateReadyState
                    289: DiskDeviceRw ==> IODiskReadingAndWriting
                    290: subtle changes to changes DiskDeviceRw protocol, will need hand tweaking.
                    291:        - no 'in' or 'out'
                    292:        - pending is type void *
                    293: -diskPresent ==> -diskBecameReady
                    294: IO_R_NOLABEL ==> IO_R_NO_LABEL
                    295: IO_R_NODISK ==> IO_R_NO_DISK
                    296: IO_R_BLK0 ==> IO_R_NO_BLOCK_ZERO
                    297: DiskReadyState ==> IODiskReadyState
                    298: diskStatsIndices ==> IODiskStatIndices
                    299: DISK_STATS_ARRAY_SIZE ==> IO_DISK_STAT_ARRAY_SIZE
                    300: partId ==> partitionId
                    301: 
                    302: * DiskDeviceKern.h
                    303: Renamed file to kernelDiskMethods.h
                    304: Renamed category from Kern to kernelDiskMethods
                    305: DISK_UNIT ==> IO_DISK_UNIT
                    306: DISK_PART ==> IO_DISK_PART
                    307: diskIoComplete: API changed, will need hand tweaking
                    308:        is completeTransfer:withStatus:actualLength
                    309: getIdMap ==> devAndIdInfo
                    310: setIdMap ==> setDevAndIdInfo
                    311: diskBlockDev ==> blockDev
                    312: diskRawDev ==> rawDev
                    313: moved -registerUnixDisk, -unregisterUnixDisk to kernelDiskMethodsPrivate.h
                    314: * IOLogicalDisk
                    315: _physDevice ==> _physicalDisk
                    316: connectToPhysDev ==> connectToPhysicalDisk
                    317: moved _diskParamCommon to IOLogicalDisk.m
                    318: _isDiskOpen is now type BOOL
                    319: isOpen, anyOtherOpen now return BOOL
                    320: anyOtherOpen ==> isAnyOtherOpen
                    321: _physBlockSize ==> _physicalBlockSize
                    322: _physDisk ==> _physicalDisk
                    323: deleted setPhysDevice 
                    324: physDevice ==> physicalDisk
                    325: physBlockSize ==> physicalBlockSize
                    326: setPhysBlockSize ==> setPhysicalBlockSize
                    327: _diskIsOpen ==> _instanceOpen
                    328: -diskIsOpen ==> isInstanceOpen
                    329: -setDiskIsOpen ==> setInstanceOpen
                    330: 
                    331: * NXDisk
                    332: Renamed file to IODiskPartition.h
                    333: Renamed class to IODiskPartition
                    334: NXDiskPublic ==> IODiskPartitionExported
                    335: getLabel ==> readLabel
                    336: _blockDevOpen ==> _blockDeviceOpen
                    337: _rawDevOpen ==> _rawDeviceOpen
                    338: _labelValid, _blockDeviceOpen, _rawDeviceOpen all BOOL
                    339: blockDevOpen  ==> isBlockDeviceOpen
                    340: setBlockDevOpen ==> setBlockDeviceOpen
                    341: rawDevOpen ==> isRawDeviceOpen
                    342: setRawDevOpen ==> setRawDeviceOpen
                    343: moved all private method to IODiskPartition.m.
                    344: 
                    345: * DeviceUxpr.h
                    346: renamed file to Device_ddm.h
                    347: 
                    348: * uxprPrivate.h
                    349: renamed file to ddmPrivate.h
                    350: 
                    351: * i386/user_driver.h
                    352: renamed file to i386/driverServer.h. Made private.
                    353: Prepended '_' to all RPC names.
                    354: 
                    355: * i386/user_driver_types.h
                    356: renamed file to i386/driverTypes.h.
                    357: EISA_io_mapping_t ==> IOEISAPortRange
                    358: EISA_CONF_NIOMAP ==> IO_NUM_EISA_PORT_RANGES
                    359: EISA_io_conf_t ==> IOEISAPortMap
                    360: EISA_phys_mapping_t ==> IOEISAMemoryRange
                    361: EISA_CONF_NPHYSMAP ==> IO_NUM_EISA_MEMORY_RANGES
                    362: EISA_phys_conf_t ==> IOEISAMemoryMap
                    363: EISA_intr_req_t ==> IOEISAInterrupt
                    364: EISA_CONF_NIRQ ==> IO_NUM_EISA_INTERRUPTS
                    365: EISA_intr_conf_t ==> IOEISAInterruptList
                    366: EISA_dma_req_t ==> IOEISADMAChannel
                    367: IOEISADMAChannel.chan ==> IOEISADMAChannel.channel
                    368: EISA_CONF_NDMA ==> IO_NUM_EISA_DMA_CHANNELS
                    369: EISA_dma_conf_t ==> IOEISADMAChannelList
                    370: 
                    371: * configPublic.h
                    372: renamed to userConfigServer.h.
                    373: 
                    374: * architecture/i386/io.h
                    375: io_addr_t ==> IOEISAPortAddress
                    376: io_len_t ==> IONumEISAPorts
                    377: 
                    378: * nrw/IODeviceNRW.h
                    379: Deleted. Superceded by nrw/directDevice.h.
                    380: 
                    381: ............
                    382: file: ~dmitch/Projects/DRIVERKIT/driverkit/doc/API_Change_log

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.