© 1983-2012 Novell. See COPYRIGHT file for details.

NCP Documentation Errata Sheet
Date Affected
NCP
NCP
Family Name

Changes Summary
10-24-96 ncp 23 244 File System The Directory Handle variable was documented as a LONG field. It is actually a BYTE field.
10-29-96 ncp 90 130 Data Migration The documentation should have shown 4 more return fields than was listed.
10-29-96
File System The documentation defined RReferenceID as a long, when it is actually a word.
10-29-96 ncp 22 42 File System The documentation shows the sub-function length with a 2 plus ... when it should of been 3 plus ....
12-16-96 ncp 123 56 Statistical The ServerName in the KnownServStruc reply buffer is null terminated instead of as previously documented to be length preceeded.
12-16-96 ncp 23 205 File Server Environment This NCP can be used by a user without console privileges. The documentation used to state that you couldn't. Changed return code "no privileges" to "Unknown Request".
12-16-96 ncp 22 34 File System Subfunction structure length should be 6. Documentation used to say 5.
12-17-96 NDS Protocol Verb 34 Novell Directory Services NDS Protocol verb DSV_UPDATE_SCHEMA (0x22) shows incorrect response "Returns only NCP header". Should be uint32 version.
12-17-96 ncp 123 01 Statistical If Subfunction structure length = = 3 and version = = 1, you get back ExtraCacheCounters in addition to other Cache info.
2-4-97 ncp 87 31 File System Updated the NCP 87 31 documentation to include all levels of information that can be returned.
2-13-97 ncp 123 27 Statistical Updated the NCP 123 27 doc to describe the ProtocolID and ProtocolName reply field formats.
2-13-97 ncp 123 24 Statistical Updated the NCP 123 24 doc to fully describe the reply fields that can be returned. The old doc showed 1 BoardName being returned instead of a full, short and logical board name that are really returned if present. They are all ASCIIZ strings.
2-28-97 ncp 104 02 Novell Directory Services The offset for ReplyData was 14 and should have been 16. Also, ReplyData is a byte[], the size of which is determined by the verb used in the request and the ReplySize.
3-12-97 ncp 23 243 File System Added a description of what comes back in the reply buffer for "Path". The path is returned as a group of components. Each directory, subdirectory or file in the path is considered to be a component. Each component is length preceeded and is followed by the next component. The path is ended by a null. The volume name is NOT returned as a component in the path.
3-18-97 ncp 87 01
ncp 87 30
ncp 87 32
ncp 87 33
File System If creating a subdirectory, the DesiredAccessRights parameter is NOT used to specify Access Rights. It is used to specify an Inherited Rights Filter. This would typically be passed in as 0xFF. This applies to all of the listed NCPs.
3-28-97 ncp 104 03
ncp 104 07
Novell Directory Services Added several NCP verb definitions. Also started updating and correcting the NDS protocol verb definitions.
6-3-97 ncp 23 29 Connections Added a missing error code 224 (0xE0) ERR_NO_LOGIN_CONNECTIONS_AVAILABLE.
6-3-97 ncp 36 00 NCP Extensions The documentation for NCP 36 00 incorrectly stated that the NCP request required an NCP Extension name and length when an NCP Extension Number was what was required. Added a SubFuncStrucLen to the request packet. Also the reply packet did not show that an additional 32 bytes of custom data is returned.
6-3-97 ncp 36 01 NCP Extensions The documentation for NCP 36 01 incorrectly stated that the NCP request required an NCP Extension name and length when neither of these fields are used. Also added a SubFuncStrucLen to the request packet.
6-3-97 ncp 36 02 NCP Extensions Added a SubFuncStrucLen to the request packet, and also added a CustomData field to the reply packet which is an additional 32 bytes of custom data that may be optionally returned.
6-3-97 ncp 36 03 NCP Extensions Added a SubFuncStrucLen to the request packet.
6-3-97 ncp 36 04 NCP Extensions Added a SubFuncStrucLen to the request packet. Also added a note indicating the StartingNumber should be set to 0 for the initial request.
6-3-97 ncp 36 05 NCP Extensions The documentation for NCP 36 05 incorrectly stated that the NCP request required an NCP Extension name and length when an NCP Extension Number was what was required. Added a SubFuncStrucLen to the request packet. Also the reply packet did not show that an additional 32 bytes of custom data is returned.
6-3-97 ncp 36 06 NCP Extensions The documentation for NCP 36 06 incorrectly stated that the NCP request required an NCP Extension Number. Also added a SubFuncStrucLen to the request packet.
9-16-97 ncp 123 60 Statistical NCPs The SetCmdFlags and SetCmdName reply fields are null terminated strings, not length preceeded strings.
9-18-97 ncp 104 02 NDS Function 2 Novell Directory Services The fields entryID & infoFlags were reveresed. The ordering should be the infoFlags field then the entryID field.
10-28-97 ncp 123 16 Statistical NCPs New MOAB NCP. Will allow client to enumerate for information on a provided connection list.
10-28-97 ncp 123 17 Statistical NCPs New MOAB NCP. Will allow client to enumerate for a list of NCP Services Network Addresses that the server supports.
1-20-98 ncp 21 12 Message NCPs New MOAB NCP. Will allow client to control Broadcast & Watchdog Messages for connections in supplied list.
2-2-98 ncp 123 27 Statistical NCPs Changed the unused or reserved parameter in the reply buffer from a WORD to a BYTE, and added another parameter (numberOfProtocols) to the reply buffer. This is so that the issuer can tell how many protocols are bound to a board and iterate on numberOfProtocols to pull them out of the buffer. This was actually done 11-18-96.
2-6-98 ncp 23 235 File Server Environment NCPs Changed the ParentDirectoryNumber and DirectoryNumber fields which are returned to DOSParentDirectoryNumber and DOSDirectoryNumber respectively. There was confusion about which name space the directory entries referred to when the namespace field returned something other than DOS. The namespace field applies only to the FileName that is also returned.
2-13-98 ncp 123 17 Statistical NCPs Changed the subfunction structure length from 6 to 5.
2-27-98 ncp 23 33 Connection NCPs New NCP (23 33 Generate GUIDs) for MOAB.
2-27-98 ncp 123 10 Statistical NCPs Removed the more field from the reply buffer and replaced it with an unused field. Added a field to indicate the total number of NLMs loaded as well as the number of nlm numbers returned in the list.
2-27-98 ncp 87 07 File system NCPs There were 2 name bits defined in the ModifyDOSInfoMask table in the file system section. Changed bit one from "name bit" to "Attribute Bit" and bit zero from "name bit" to "Unused bit". This is because in NCP 87 07, the modify name bit should not be available since you can't change the name with this NCP.
3-4-98 ncp 123 17 Statistical NCPs Added a 16 byte serverGUID field to the reply.
3-19-98 ncp 37 NCP Extension NCPs Updated the request and reply data to show neccessary fields if issuing NCP 37 (NCP Extension Request).
6-10-98 ncp 23 17 File Server Environment NCPs Defined reserved byte 76 to be defined as the MixedModePathHandling indicator flag. This byte will be set to one if the server supports the handling of DOS & LONG names in a specified path.
6-26-98 Return Info Mask (ncp 87 ) File system NCPs Defined in the ReturnInfoMask field, a bit to request the LastAccessedTime on a file to be returned. This bit can only be selected if the RNewStyle bit is enabled.
6-27-98 ncp 90 00 File system NCPs If this bit is set, then for each file that ParseTree finds, it will return a WORD containing the LastAccessedTime (in DOS format).
11-3-98 ncp 123 08 Statistical NCPs Added a reserved (WORD) field and changed the NumberOfCPUs in the reply buffer from a WORD to a LONG. Also removed comment that the number of CPUs was always "currently set to 1".
11-3-98 ncp 123 71 Statistical NCPs Added NCP 123 71 to the NCP page table so it would be accessible.
11-3-98 ncp 123 72 Statistical NCPs Added NCP 123 72 to the NCP page table so it would be accessible.
11-3-98 ncp 87 20 File System The MoreEntriesFlag field is set to 0xff when more entries are available. The documentation used to say this would be set to 1.
11-13-98 ncp 87 43 File System Added documentation for NCP 87 43 (Revoke File Handle Rights. This NCP was introduced in April 1996 for NetWare v4.11. See NCP for additional details.
1-11-99 ncp 22 51 File System Fixed documentation for NCP 22 51. The volumeNumber field was documented as a long, but actually is a byte.
1-13-99 ncp 23 17 File Server Environment NCPs Changed remark about MaximumServiceConnections to indicate that it is a count of the maximum number of connection slots that the server has allocated since it has been up. It does not indicate how many connections the server supports, or necessarily show how many connections are currently logged in. Also changed the description of MaxConnectionsEverUsed to reflect that this reply field is referring to "licensed" connections only.
1-25-99 ncp 123 16 Statistical NCPs Added additional comments regarding the connectionInfo structure returned. It will always contain the connection number for each item returned, then additional connection information as requested in the mask.
2-9-99 ncp 87 36 Synchronization NCPs Changed the subfunction code from 33 to 36. Also linked NCPs 87 36, 87 37, and 87 38 from the ncppage87.htm to the sync.htm file. These NCPs used to not show up under NCP 87.
2-10-99 ncp 87 40 File System Added the documentation for NCP 87 40. (Search For File or Subdirectory Set (Extended errors)). This NCP was added in the v4.11 time frame.
2-11-99 ncp 87 41 File System Added the documentation for NCP 87 41. (Scan Salvageable File List) This NCP was added in the v4.11 release.
2-11-99 ncp 87 42 File System Added the documentation for NCP 87 42. (Purge Salvageable File List) This NCP was added in the v4.11 release.
2-11-99 ncp 87 39 File System Added the documentation for NCP 87 39. (Get Directory Disk Space Restrictions) This NCP was added in the v4.11 release.
2-17-99 ncp 23 32 Bindery Added the documentation for NCP 23 32. (Scan Objects (List)) This NCP was added in the v4.11 release.
2-18-99 File System Intro File System Added to the "Attributes Definition" table in the File System Introduction section. The "Subdirectories Only" bit (bit 4) was missing, and the "Archive" bit was shown as bit 4 instead of bit 5.
2-19-99 ncp 87 05 File System Changed request field offset for NWHandlePathStruct from 14 to 16.
3-11-99 ncp 87 01 File System Changed reply field "FileHandle" from 6 bytes to a long.
3-11-99 ncp 87 34 File System Added (Hi-Lo) to the request packet CCFileHandle definition and a comment about the FileHandle.
3-11-99 ncp 87 43 File System Added (Hi-Lo) to the request & reply packet FileHandle definitions and a comment about the FileHandle.
3-11-99 ncp 123 61 Statistical NCPs Switched the order in which NumberOfSetCategories and NextStartNumber appear in the reply buffer. Also removed the CategoryNameLen reference since this NCP does not use that and is in ASCIIZ format. Updated the comments to indicate this.
3-12-99 ncp 87 10
ncp 87 11
File System Added comments about the use of the NetWare Handle Path Structure to NCP 87 10, 87 11 and to the "NetWare Handle and Path Structure Definition" explanation in the "File System NCPs" section.
4-8-99
File System Under File Security, the definitions for Bits 11 and 13 were changed. Bit 11 now correctly describes the suballoc bit (rather than a "reserved" bit). Bit 13 is now correctly marked as Reserved.
5-3-99 ncp 59 File System In the request packet, the number of bytes for the reserved field was changed from 3 to 1.
5-5-99 ncp 123 23 Statistical In the request packet, changed the "moreflag" field to "Unused" and eliminated any references to "moreflag." Also added explanation on how to ensure all information has been received by using the StartNumber and NumOfCCinPkt fields.
5-24-99 ncp 123 17 Statistical Changed offset 14 in the reply header from the reserved to the serverInfoFlags parameter, which is still in little Endian order. Also, documented the CLUSTER_MEMBER_BIT 0x00000001 constant defined for this parameter.
6-16-99 ncp 87 06 File System Added a description of the date and time values in the NetWareInfoStruct.
6-16-99 ncp 131 01 RPC Deleted the Return Value, 158 Bad File Name or No File Name Given.
6-17-99 ncp 23 26 Connection Added connection type 11-UDP (for IP). Also added a description on how this NCP behaves when issued from an IP-only server.
6-18-99 ncp 87 04 File System Added the RenameFlag bit definitions and descriptions.
7-7-99 ncp 23 243 File System Removed the statement about path being NULL terminated (per Chaofeng Kao). Also added brief example of how path uses a length-preceded string to return a directory path.
7-28-99 All NCPs
Added v5.x indicator to each NCP table describing what version of NetWare that NCP is supported on.
7-28-99 ncp 87 07 File System Changed the offsets of ModifyDOSInfoStruct and NWHandlePathStruct from 44 to 16 and from 82 to 54 respectively.
7-28-99 ncp 123 27 Statistical Changed the description of offset 15 in the reply buffer. For NetWare 4.x, this offset is reserved. For NetWare 5.x, this offset is numberOfProtocols. Also added some comments about this in the Remarks section.
8-6-99 ncp 23 32 Bindery Changed InfoFlags in the request buffer, from Lo-Lo to Lo-Hi.
8-6-99 ncp 97 Connections Updated the explanation of SecurityFlag fields in the request and reply.
8-10-99 ncp 21 10 Message NCPs Added indicator stating that this NCP is supported in NetWare v3.12.
8-10-99 ncp 23 236 File Server Environment Changed SubFunctionStrucLen from (5 + Pathlen) to (9). Also added Convert Path to Dir Entry 0x2222 23 244 as another way to obtain the DirectoryBase entry number.
8-11-99 ncp 87 22 File System Changed the descriptions of dstNameSpace and dstNSIndicator to utilize the 'Jn' designation. Also added a paragraph to the Remarks section to further explain the 'Jn' functionality.
9-15-99 ncp 22 40 File System Added a description for reply fields DataForkFirstFAT and OtherFileForkSize.
9-15-99 File System Intro File System Added a description for the MaximumSpace field in the ModifyDOSInfoStructure.
9-15-99 ncp 87 26 File System Added descriptions for HugeStateInfo and HugeDataLen fields.
9-15-99 ncp 87 27 File System Added descriptions for HugeStateInfo and HugeDataLen fields.
10-1-99 File System Intro File System Added field definitions for LastAccessedTimeStruct and MacTimeStruct structures.
10-8-99 File System Intro File System Added description for SiblingCount (count for subdir will always be zero) under SiblingCountStruct in ExtendedReturnInfoMask section.
10-14-99 ncp 22 41 File System Changed the length of SubFuncStrucLen from 5 to 6.
10-19-99 ncp 123 31 Statistical Changed the initial value that startNum should be, from zero to -1.
10-25-99 ncp 23 253 File Server Environment Added remark that this NCP can accept messages up to 250 bytes in length.
10-25-99 ncp 21 09 Message NCPs Changed the maximum message length from 60 to 255 bytes.
11-2-99 ncp 87 01
ncp 87 30
ncp 87 32
ncp 87 33
File System Added additional comments about the OpenCreateMode values that can be passed into any of these NCPs.
11-2-99 ncp 87 43 File System Removed return value 255 and changed the return value of 253 to be Bad Station Number with an accompanying explanation.
11-3-99 ncp 23 17 File Server Environment Added 4 new fields to the reply buffer as requested by the server install team. These start at offset 77.
12-13-99 ncp 87 06 File System Added a comment indicating that the SearchAttributes request field is not used, and any value passed in in this field is ignored. Any existing file or subdir will be found if requested.
12-16-99 ncp 123 62 Statistical Added new ncp for COBRA. NCP 123 62 (Get Server Set Commands Information by Name) will return info about a set parameter by passing in the name instead of a start number.
12-20-99 ncp 104 03 Novell Directory Services Added documentation for NCP 104 03 NDS Fragment Close.
1-03-2000
NCP Concepts Added documentation to the main menu to view NCP info by concept.
1-03-2000
NCP Introduction Added NCP introduction documentation to the concepts menu.
1-18-2000 ncp 22 51 File System Changed the subfunction structure length from 5 to 2.
2-1-2000 ncp 87 43 File System Fixed the offsets of the Request fields starting with QueryFlag. It used to be 8 instead of the correct value of 11. Adjusted the others accordingly.
2-1-2000 ncp 87 44 File System Added documentation for NCP 87 44 (Update File Handle Rights). This NCP was introduced in v5.0 support pack 3 for the NT client team.
2-3-2000 File System Intro File System Added a description for TtlDSDskSpaceAlloc in the NetWareInformationStructure's "Total Streams Data Size Information Structure".
2-3-2000 ncp 123 03 Statistical Added definitions for the File System Info Structure that is returned.
2-3-2000 ncp 123 34 Statistical Added definitions for the VolInfoDef & VolInfo2Def structures that can be returned.
6-15-2000 ncp 87 32
ncp 87 33
File System Updated definitions and return values for the OCRetFlags (callback) field.
6-27-2000 ncp 22 51 File System Added definitions for the reply buffer which are the same as NCP 123 34.
7-12-2000 ncp 22 32 File System Changed the number of entries that can be returned from this NCP from 12 to 16, along with a better description of how to get additional entries.
7-12-2000 ncp 72 File System Added a note indicating that comments about clients not being able to straddle block boundries do not apply in NetWare 5.x
7-12-2000
Case 90 NCPs Removed an invalid reference to NCP 90 150.
7-12-2000 ncp 90 129 Data Migration Removed a request field that was incorrect (DOSDirectoryEntry). Also in the reply field, removed the invalid SMmediaString that was not used, and added RestoreTime. Changed the DMINFO structure to only include the data stream size and not the data stream number.
7-13-2000 ncp 90 132 Data Migration Added information about info level 2 that can be returned in a reply.
8-14-2000
NCPs by Number NCP 30 (Clear Physical Record Lock) had been accidently omitted from the NCPs by number reference. Put it back in.
9-08-2000 NCP 114 1, 2, 5, 6, 12 Timesync NCPs Added 5 Timesync case 114 NCPs. These are registered when timesync.nlm loads.
10-4-2000 ncp 131 02 RPC Changed the input parameter name from PathAndName to NLMName. No path is necessary to unload the nlm. Also modified the comments about this.
10-4-2000 ncp 131 05 RPC Corrected the SubFuncStrucLen and the SubFuncCode. Also changed the name of the input parameter AddNameSpace to AddNameSpaceAndVol. Added comments to reflect that the name space should be followed by a space and then the volume name with no colon. This is an ASCIIZ string.
10-4-2000 ncp 131 06 RPC Corrected the SubFuncStrucLen and the SubFuncCode.
10-13-2000
NCP Completion Code List Added NCP Completion Code List documentation to the concepts menu. This list is derived from the server's errors.h file.
10-27-2000 ncp 87 04 File System Changed the value of the RNameOnlyFlag from 0x3 to 0x4.
10-27-2000 File System Intro File System Changed all references of "Write Only Mode" to "Write Access Mode" and all references of "Read Only Mode" to "Read Access Mode".
11-28-2000 ncp 114 01 Timesync NCPs Added additional comments about the reply fields.
12-05-2000 ncp 23 17 File Server Environment Added reference to OSLanguageID that is now returned. The OSLanguageID is the number of the Language that is enabled on the server.
02-06-2002 ncp 23 17 File Server Environment Added reference to 64BitIOSupportedFlag that is now returned. This flag indicates whether 64 bit file offsets are supported on the server.
02-06-2002 ncp 87 64
ncp 87 65
ncp 87 66
ncp 87 67
ncp 87 68
ncp 87 69
File System Added info about 6 new NCPs (read, write, lock) that are 64 bit capable on NSS but will still return 32 bit info on legacy volumes.
02-06-2002 New Style NetWare Info Structure File System Added comments to the New Style NetWare Info Structure section. It now includes descriptions about the 64BitFileSize bit that is supported for NSS volumes and that can be obtained using NCPs 87 1, 87 30, 87 32, 87 33, 87 3, 87 6, 87 20, 87 16, 87 29. This will return true 64 bit file sizes on NSS volumes, and 32 bit file sizes on legacy volumes.
02-13-2002 ncp 22 51 File System Added a new status flag bit (64BitFileOffsetsEnabledBit) (0x40) that will indicate whether 64 bit offsets are enabled for a given volume. NSS volumes are currently the only volumes supporting this. NCP requests using the 64 bit offsets, directed at legacy volumes will support 32 bit offsets.
03-14-2002 ncp 28
ncp 30
ncp 109
Synchronization NCPs Changed the ordering of LockAreaStartOffset and LockAreaLen parameters from Lo-Hi to Hi-Lo.
03-14-2002 ncp 105
ncp 106
ncp 107
ncp 108
ncp 109
ncp 110
Synchronization NCPs Changed the ordering of the LockTimeout parameter from Lo-Hi to Hi-Lo.
03-14-2002 ncp 32 00
ncp 32 01
ncp 32 02
ncp 32 03
ncp 32 04
Synchronization NCPs Changed the ordering of the SemaphoreHandle parameter from Hi-Lo to Lo-Hi.
03-14-2002 ncp 111 02 Synchronization NCPs Changed the ordering of the SemaphoreTimeOut parameter from Lo-Hi to Hi-Lo.
03-29-2002 ncp 87 01
ncp 87 30
ncp 87 32
ncp 87 33
File System Added reference to the new OpenCreateMode OPEN_64BIT_ACCESS (0x20) that is available to open files that have a size greater than 4 gig. This bit does nothing on a legacy file system volume, but allows opens on an NSS volume.
4-10-2002 ncp 92 xx SecretStore NCPs Added general NCP documentation for the SecretStore NCPs that the security services team registers and maintains.
8-28-2003 ncp 123 16 Statistical Added new structure of information (LanguageInfo) that can be returned if the new mask LanguageInfoBit 0x100 is specified. This will retrieve info that new NCP 23 34 (Set Language Encoding info) can set.
8-28-2003 ncp 23 34 Connections Added a new NCP 23 34 (Set Connection Language Info) that will allow the setting of the connection code page and the setting on the connection status field indicating whether NCP requests can come in in UTF8 format to volumes and file systems that support this.
08-28-2003 ncp 22 51 File System Added a new status flag bit (UTF8NCPStringsEnabledBit) (0x80) that will indicate whether a given volume supports incoming NCP requests containing path strings encoded in UTF8. NSS volumes are currently the only volumes supporting this.
12-16-2003 Case 89 NCPs Enhanced File System NCPs Added new enhanced file system NCPs under Case 89. These NCP's subfunction numbers correspond with the Case 87 NCP's subfunction numbers. The difference between the 2 is that the Case 89 NCPs allow sending/returning of path string data in either UTF8 format or Ascii format. A field has been added to the NetWareHandlePathStruct which indicates which format is being received and/or returned. The component path strings are now WORD length preceeded rather than BYTE length preceeded. NSS volumes all calling these new NCPs with UTF8 formatted data. The traditional file system only allows Ascii to be passed with these NCPs.
01-22-2004 ncp 87 12 File System Changed "reserved" input field to DstNameSpace and added comments below about additional Allocate Mode bits and their usage.
2-10-2004 ncp 87 65 File System Changed offset of input parameter "Data" from 24 to 22.
2-10-2004 ncp 87 09 File System Changed input parameter "Reserved" to "Flags". Also updated the documentation regarding the reply fields if the Flags field is set to either zero or 0x40.
03-10-2004 ncp 87 64
ncp 87 65
ncp 87 66
ncp 87 67
ncp 87 68
ncp 87 69
File System Added 6 new NCPs that allow 64 bit offsets for files greater than 4 gig in size. This is available only on NSS volumes. These were added on 2-14-2002, in Netware v6.sp2 and newer. They are not available on Netware 5x.
06-1-2005 ncp 87 03
ncp 87 20
ncp 87 66
ncp 87 67
File System Updated the doc to correct statements about the NetWareFileNameStruct. It used to indicate that the name was always returned regardless of whether this bit was set or not, on NCP 87 3 and 89 3. In fact, it is only always set on NCP 87 20 and 89 20. Otherwise, the caller must add this bit in to the ReturnInfoMask that is passed in.
6-6-2005 ncp 23 17 File System Added a NCP Server Platform indicator field so that the caller can know what host OS version the NCP Engine is running on. Currently, a zero indicates that the host OS is NetWare, and a 1 indicates that it is running on Linux.
7-6-2005 ncp 22 53 File System Added a new NCP 22 53 in OES Linux to get a volume's attributes and capabilities.
1-3-2006 ncp 89 21 File System Added a new NCP 89 21 to get the path string back from a dir handle. This was added in Netware v65.sp4.
8-23-2007 ncp 22 44 File System Changed the subfunction structure length from 1 to 2.