From 1ff6d524dd95d873b50d55d5757050b1228631fe Mon Sep 17 00:00:00 2001 From: Yangys Date: Thu, 16 Feb 2023 14:13:43 +0800 Subject: [PATCH] Update ErrorCode Signed-off-by: Yangys --- .../reference/apis/js-apis-socket.md | 6 +- .../reference/errorcodes/Readme-CN.md | 8 +- .../errorcodes/errorcode-net-connection.md | 113 ++++++ .../errorcodes/errorcode-net-ethernet.md | 116 ++++++ ...rrorcode-http.md => errorcode-net-http.md} | 0 .../errorcodes/errorcode-net-policy.md | 59 +++ .../errorcodes/errorcode-net-sharing.md | 159 ++++++++ .../errorcodes/errorcode-net-socket.md | 351 ++++++++++++++++++ .../reference/errorcodes/errorcode-socket.md | 77 ---- 9 files changed, 806 insertions(+), 83 deletions(-) create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-net-connection.md create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-net-ethernet.md rename zh-cn/application-dev/reference/errorcodes/{errorcode-http.md => errorcode-net-http.md} (100%) create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-net-policy.md create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-net-sharing.md create mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-net-socket.md delete mode 100644 zh-cn/application-dev/reference/errorcodes/errorcode-socket.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-socket.md b/zh-cn/application-dev/reference/apis/js-apis-socket.md index 3fec6d556f..aacfb4068f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-socket.md +++ b/zh-cn/application-dev/reference/apis/js-apis-socket.md @@ -716,7 +716,7 @@ Socket的连接信息。 UDP 其余错误码映射形式为:2301000 + 内核错误码。 -错误码的详细介绍参见[Socket错误码](../errorcodes/errorcode-socket.md) +错误码的详细介绍参见[Socket错误码](../errorcodes/errorcode-net-socket.md) ## socket.constructTCPSocketInstance @@ -1594,7 +1594,7 @@ TCPSocket连接的其他属性。 TCP 其余错误码映射形式为:2301000 + 内核错误码。 -错误码的详细介绍参见[Socket错误码](../errorcodes/errorcode-socket.md) +错误码的详细介绍参见[Socket错误码](../errorcodes/errorcode-net-socket.md) ## socket.constructTLSSocketInstance9+ @@ -1909,7 +1909,6 @@ connect(options: TLSConnectOptions, callback: AsyncCallback\): void | 2303104 | Interrupted system call. | | 2303109 | Bad file number. | | 2303111 | Resource temporarily unavailable try again. | -| 2303113 | System permission denied. | | 2303188 | Socket operation on non-socket. | | 2303191 | Protocol wrong type for socket. | | 2303198 | Address already in use. | @@ -2009,7 +2008,6 @@ connect(options: TLSConnectOptions): Promise\ | 2303104 | Interrupted system call. | | 2303109 | Bad file number. | | 2303111 | Resource temporarily unavailable try again. | -| 2303113 | System permission denied. | | 2303188 | Socket operation on non-socket. | | 2303191 | Protocol wrong type for socket. | | 2303198 | Address already in use. | diff --git a/zh-cn/application-dev/reference/errorcodes/Readme-CN.md b/zh-cn/application-dev/reference/errorcodes/Readme-CN.md index bf7667cdd0..7f7d7b8807 100644 --- a/zh-cn/application-dev/reference/errorcodes/Readme-CN.md +++ b/zh-cn/application-dev/reference/errorcodes/Readme-CN.md @@ -47,8 +47,12 @@ - [文件管理子系统错误码](errorcode-filemanagement.md) - 网络管理 - [上传下载错误码](errorcode-request.md) - - [HTTP错误码](errorcode-http.md) - - [Socket错误码](errorcode-socket.md) + - [HTTP错误码](errorcode-net-http.md) + - [Socket错误码](errorcode-net-socket.md) + - [网络连接管理错误码](errorcode-net-connection.md) + - [以太网连接错误码](errorcode-net-ethernet.md) + - [网络共享错误码](errorcode-net-sharing.md) + - [策略管理错误码](errorcode-net-policy.md) - 通信与连接 - [NFC错误码](errorcode-nfc.md) - [RPC错误码](errorcode-rpc.md) diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-net-connection.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-connection.md new file mode 100644 index 0000000000..27ed5c0d89 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-net-connection.md @@ -0,0 +1,113 @@ +# 网络连接管理错误码 + +## 2100001 非法参数值 + +**错误信息** + +Invalid parameter value. + +**错误描述** + +非法参数值。 + +**可能原因** + +输入参数取值范围错误。 + +**处理步骤** + +检查输入参数的取值范围是否正确。 + +## 2100002 连接服务失败 + +**错误信息** + +Operation failed. Cannot connect to service. + +**错误描述** + +操作失败,连接系统服务发生异常。 + +**可能原因** + +服务发生异常。 + +**处理步骤** + +检查系统服务运行状态是否正常。 + +## 2100003 系统内部错误 + +**错误信息** + +System internal error. + +**错误描述** + +系统内部错误。 + +**可能原因** + +1、内存异常。 + +2、空指针。 + +**处理步骤** + +1、检查内存空间是否充足,清理内存后重试。 + +2、系统异常,请稍后重试或重启设备。 + +## 2101007 已存在相同的callback + +**错误信息** + +The same callback exists. + +**错误描述** + +已经注册的Callback。 + +**可能原因** + +激活&监听指定属性网络并注册回调时,Callback对象重复注册。 + +**处理步骤** + +确保Callback对象未进行过注册或者执行过去注册处理。 + +## 2101008 callback不存在 + +**错误信息** + +The callback is not exists. + +**错误描述** + +不存在的Callback对象。 + +**可能原因** + +未执行激活&监听指定属性网络请求并注册回调。 + +**处理步骤** + +确定执行去注册函数前是否有执行注册函数。 + +## 2101022 请求数量超过最大值 + +**错误信息** + +The number of requests exceeded the maximum. + +**错误描述** + +请求数超过了最大值。 + +**可能原因** + +激活&监听指定属性网络请求数超过了最大值。 + +**处理步骤** + +建议通过日志定位问题。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-net-ethernet.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-ethernet.md new file mode 100644 index 0000000000..280268a206 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-net-ethernet.md @@ -0,0 +1,116 @@ +# 以太网错误码 + +## 2200001 非法参数值 + +**错误信息** + +Invalid parameter value. + +**错误描述** + +非法参数值。 + +**可能原因** + +输入参数取值范围错误。 + +**处理步骤** + +检查输入参数的取值范围是否正确。 + +## 2200002 连接服务失败 + +**错误信息** + +Operation failed. Cannot connect to service. + +**错误描述** + +操作失败,连接系统服务发生异常。 + +**可能原因** + +服务发生异常。 + +**处理步骤** + +检查系统服务运行状态是否正常。 + +## 2200003 系统内部错误 + +**错误信息** + +System internal error. + +**错误描述** + +系统内部错误。 + +**可能原因** + +1、内存异常。 + +2、空指针。 + +**处理步骤** + +1、检查内存空间是否充足,清理内存后重试。 + +2、系统异常,请稍后重试或重启设备。 + +## 2201005 设备信息不存在 + +**错误信息** + +The device information does not exist. + +**错误描述** + +设备信息不存在。 + +**可能原因** + +设置的设备或者获取的设备不存在。 + +**处理步骤** + + ```bash + > hdc shell ifconfig + ``` + 查看是否有对应的设备,比如eth0、eth1。 + +## 2201006 设备未连接 + +**错误信息** + +Device disconnected. + +**错误描述** + +设备未连接。 + +**可能原因** + +硬件网卡问题。 + +**处理步骤** + +需要查看以太网服务和底层netsys的log,查看kernel是否有上报连接状态。 + +## 2201007 用户配置写入失败 + +**错误信息** + +Failed to write the user configuration. + +**错误描述** + +写入配置文件信息失败。 + +**可能原因** + +系统报错。 + +**处理步骤** + +系统内部错误,出现的情况不明确,建议通过日志定位问题。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-http.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-http.md similarity index 100% rename from zh-cn/application-dev/reference/errorcodes/errorcode-http.md rename to zh-cn/application-dev/reference/errorcodes/errorcode-net-http.md diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-net-policy.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-policy.md new file mode 100644 index 0000000000..48a0411423 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-net-policy.md @@ -0,0 +1,59 @@ +# 策略管理错误码 + +## 2100001 非法参数值 + +**错误信息** + +Invalid parameter value. + +**错误描述** + +非法参数值 + +**可能原因** + +输入参数取值范围错误。 + +**处理步骤** + +检查输入参数的取值范围是否正确。 + +## 2100002 连接服务失败 + +**错误信息** + +Operation failed. Cannot connect to service. + +**错误描述** + +操作失败,连接系统服务发生异常。 + +**可能原因** + +服务发生异常。 + +**处理步骤** + +检查系统服务运行状态是否正常。 + +## 2100003 系统内部错误 + +**错误信息** + +System internal error. + +**错误描述** + +系统内部错误。 + +**可能原因** + +1、内存异常。 + +2、空指针。 + +**处理步骤** + +1、检查内存空间是否充足,清理内存后重试。 + +2、系统异常,请稍后重试或重启设备。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-net-sharing.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-sharing.md new file mode 100644 index 0000000000..9cd108a086 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-net-sharing.md @@ -0,0 +1,159 @@ +# 网络共享错误码 + +## 2200001 非法参数值 + +**错误信息** + +Invalid parameter value. + +**错误描述** + +非法参数值。 + +**可能原因** + +输入参数取值范围错误。 + +**处理步骤** + +检查输入参数的取值范围是否正确。 + +## 2200002 连接服务失败 + +**错误信息** + +Operation failed. Cannot connect to service. + +**错误描述** + +操作失败,连接系统服务发生异常。 + +**可能原因** + +服务发生异常。 + +**处理步骤** + +检查系统服务运行状态是否正常。 + +## 2200003 系统内部错误 + +**错误信息** + +System internal error. + +**错误描述** + +系统内部错误。 + +**可能原因** + +1、内存异常。 + +2、空指针。 + +**处理步骤** + +1、检查内存空间是否充足,清理内存后重试。 + +2、系统异常,请稍后重试或重启设备。 + +## 2202004 尝试共享一个不可用的iface + +**错误信息** + +Try to share an unavailable iface. + +**错误描述** + +使用了不可用的网卡。 + +**可能原因** + +使用的网卡不存在,或网卡名错误。 + +**处理步骤** + +1、通过指令查看共享的网卡是否被创建。 + + ```bash + > ifconfig -a + ``` + +2、检查网卡名是否拼写错误。 + +## 2202005 WiFi共享失败 + +**错误信息** + +WiFi sharing failed. + +**错误描述** + +开启wifi共享失败。 + +**可能原因** + +没有连接网络,获取默认网络失败。 + +**处理步骤** + +检查网络的连接是否正常。 + +## 2202006 蓝牙共享失败 + +**错误信息** + +Bluetooth sharing failed. + +**错误描述** + +开启蓝牙共享失败。 + +**可能原因** + +1、未开启蓝牙。 + +2、没有连接网络,获取默认网络失败。 + +**处理步骤** + +1、点击蓝牙图标,开启蓝牙模式。 + +2、检查网络的连接是否正常。 + +## 2202009 网络共享开启转发错误 + +**错误信息** + +Network share enable forwarding error. + +**错误描述** + +网络共享开启转发错误。 + +**可能原因** + +设置Iptables的规则失败,命令的拼接出错。 + +**处理步骤** + +开启debug日志,检查Ip tables的命令是否拼接出现问题。 + +## 2202011 无法获取网路共享配置 + +**错误信息** + +Cannot get network sharing configuration. + +**错误描述** + +无法获取网络共享的配置。 + +**可能原因** + +打开网络共享配置文件失败,文件路径出错。 + +**处理步骤** + +检查配置文件目录。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-net-socket.md b/zh-cn/application-dev/reference/errorcodes/errorcode-net-socket.md new file mode 100644 index 0000000000..3df05de06d --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-net-socket.md @@ -0,0 +1,351 @@ +# Socket 错误码 + +## 2301001 操作不允许 + +**错误信息** + +Operation not permitted. + +**错误描述** + +操作不允许。 + +**可能原因** + +非法操作。 + +**处理步骤** + +检查操作步骤。 + +## 2301002 文件不存在 + +**错误信息** + +No such file or directory. + +**错误描述** + +文件不存在。 + +**可能原因** + +文件不存在。 + +**处理步骤** + +检查文件名或文件路径。 + +## 2301003 进程不存在 + +**错误信息** + +No such process. + +**错误描述** + +进程不存在。 + +**可能原因** + +进程不存在 + +**处理步骤** + +排查进程信息。 + +## 2300004 Interrupted system call + +**错误信息** + +Couldn't resolve host name. + +**错误描述** + +系统调用中断。 + +**可能原因** + +系统调用中断。 + +**处理步骤** + +排查系统调用。 + +**TCP/UDP 错误码说明:** +> TCP/UDP Socket其余错误码映射形式为:2301000 + 内核错误码,关键信息请参考内核错误码。 + +## 2300002 系统内部错误 + +**错误信息** + +System internal error. + +**错误描述** + +系统内部错误。 + +**可能原因** + +1、内存异常。 + +2、空指针。 + +**处理步骤** + +1、检查内存空间是否充足,清理内存后重试。 + +2、系统异常,请稍后重试或重启设备。 + +## 2303104 中断系统调用 + +**错误信息** + +Interrupted system call. + +**错误描述** + +中断系统调用。 + +**可能原因** + +调有connect时,可能会导致阻塞时间过长,所以系统产生中断信号,返回EINTR错误。 + +**处理步骤** + +尝试重新走网络连接流程。 + +## 2303109 错误文件编号 + +**错误信息** + +Bad file number. + +**错误描述** + +在本地关闭的套接字上进行操作将返回该错误。 + +**可能原因** + +socket fd可能被关闭了,所以发生参数无效的错误。 + +**处理步骤** + +检查socket是否被意外关闭。 + +## 2303111 资源暂时不可用,请重试 + +**错误信息** + +Resource temporarily unavailable try again. + +**错误描述** + +系统资源暂时不可用,尝试再次调用。 + +**可能原因** + +系统资源繁忙。 + +**处理步骤** + +重新调用接口。 + +## 2303188 非套接字的套接字操作 + +**错误信息** + +Socket operation on non-socket. + +**错误描述** + +参数socket未指定一个套接字描述符。 + +**可能原因** + +参数不是套接字类型的描述符。 + +**处理步骤** + +检查代码描述符的获取是否正确。 + +## 2303191 socket协议类型错误 + +**错误信息** + +Protocol wrong type for socket. + +**错误描述** + +参数设置的协议类型错误。 + +**可能原因** + +标识了协议的Socket函数在不支持的socket上进行操作。 +如Internet UDP协议不能被标识为SOCK_STREAM socket类型。 + +**处理步骤** + +检查参数设置是否符合协议类型。 + +## 2303198 网络地址已被使用 + +**错误信息** + +Address already in use. + +**错误描述** + +地址已被使用。 + +**可能原因** + +如果应用程序试图将套接字绑定到已用于现有套接字的IP地址/端口,或未正确关闭的套接字,或仍在关闭过程中的套接字,则会发生此错误。 + +**处理步骤** + +尝试其他地址。 + +## 2303199 不能分配请求的地址 + +**错误信息** + +Cannot assign requested address. + +**错误描述** + +请求的地址在其上下文中无效。 + +**可能原因** + +当远程地址或端口对远程计算机无效时,可能发生该问题。 + +**处理步骤** + +检查地址或端口是否正确。 + +## 2303210 连接超时 + +**错误信息** + +Connection timed out. + +**错误描述** + +长时间不能和远程服务器建立连接。 + +**可能原因** + +这种情况一般发生在服务器主机崩溃。 + +**处理步骤** + +本地处理不了,需要确认远程服务器是否发生问题。 + +## 2303501 SSL为空 + +**错误信息** + +SSL is null. + +**错误描述** + +参数错误。 + +**可能原因** + +当内部发生函数执行失败时,会获取错误信息,当获取信息为null时,发生该错误。 + +**处理步骤** + +尝试重新执行一遍流程。 + +## 2303502 tls读取错误 + +**错误信息** + +Error in tls reading. + +**错误描述** + +等待套接字可读。 + +**可能原因** + +底层socket阻塞。 + +**处理步骤** + +重新执行接收数据的操作。 + +## 2303503 tls写入错误 + +**错误信息** + +Error in tls writing. + +**错误描述** + +等待套接字可写。 + +**可能原因** + +发送端缓冲区已满时,底层套接字发送将给出EWOUDLBLOCK错误,这意味着服务器没有读取从客户端发送的消息。 + +**处理步骤** + +需要检查服务器并修复它。 + +## 2303504 查找x509时出错 + +**错误信息** + +Error looking up x509. + +**错误描述** + +认证x509证书发生错误,操作未完成。 + +**可能原因** + +本地证书和服务器证书不匹配。 + +**处理步骤** + +检查本地CA跟证书和服务器证书是否匹配。 + +## 2303505 tls系统调用错误 + +**错误信息** + +Error occurred in the tls system call. + +**错误描述** + +发生了一些不可恢复的致命I/O错误。 + +**可能原因** + +网络问题,导致通信失败。 + +**处理步骤** + +请参阅Unix系统的errno以了解详细信息。 + +## 2303506 清除tls连接出错 + +**错误信息** + +Error clearing tls connection. + +**错误描述** + +TLS/SSL连接已关闭。 + +**可能原因** + +协议中出现关闭警报时,即连接已完全关闭时,才会返回此结果代码。 + +**处理步骤** + +尝试重新发起连接。 \ No newline at end of file diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-socket.md b/zh-cn/application-dev/reference/errorcodes/errorcode-socket.md deleted file mode 100644 index 687ef15d7e..0000000000 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-socket.md +++ /dev/null @@ -1,77 +0,0 @@ -# TCP/UDP 错误码 - -## 2301001 操作不允许 - -**错误信息** - -Operation not permitted. - -**错误描述** - -操作不允许。 - -**可能原因** - -非法操作。 - -**处理步骤** - -检查操作步骤。 - -## 2301002 文件不存在 - -**错误信息** - -No such file or directory. - -**错误描述** - -文件不存在。 - -**可能原因** - -文件不存在。 - -**处理步骤** - -检查文件名或文件路径。 - -## 2301003 进程不存在 - -**错误信息** - -No such process. - -**错误描述** - -进程不存在。 - -**可能原因** - -进程不存在 - -**处理步骤** - -排查进程信息。 - -## 2300004 Interrupted system call - -**错误信息** - -Couldn't resolve host name. - -**错误描述** - -系统调用中断。 - -**可能原因** - -系统调用中断。 - -**处理步骤** - -排查系统调用。 - -**TCP/UDP 错误码说明:** -> 其余错误码映射形式为:2301000 + 内核错误码,关键信息请参考内核错误码。 - -- GitLab