ohos-networkShare

Overview

Network sharing management CLI tool for OpenHarmony. This tool provides commands to check network sharing support status, query current sharing state, and control network sharing (start/stop) for different sharing types including WiFi, USB, and Bluetooth.

Features

• Check if network sharing is supported on the device
• Check current network sharing status
• Start network sharing for WiFi, USB, or Bluetooth
• Stop network sharing for WiFi, USB, or Bluetooth

Dependencies

System Capability

• SystemCapability.Communication.NetManager.NetSharing

Libraries

• net_tether_manager_if (Network sharing client library)

Permissions

• ohos.permission.CONNECTIVITY_INTERNAL (System permission required for all operations)

System Requirements

• Must be executed by system processes (system caller check)
• EDM policy check for persist.edm.tethering_disallowed (for start command)

Basic Usage

ohos-networkShare <command> [args]

Command List

Command	Description	Arguments	Permission	Prerequisites
help	Show help information	[command] [--format json]	None	None
is-supported	Check if network sharing is supported	None	ohos.permission.CONNECTIVITY_INTERNAL	None
is-sharing	Check if network sharing is currently active	None	ohos.permission.CONNECTIVITY_INTERNAL	None
start	Start network sharing	<wifi	usb	bluetooth>
stop	Stop network sharing	<wifi	usb	bluetooth>

Prerequisites Description:

• None: The command can be executed directly without any prerequisites.

Examples

# Show help information (all commands)
ohos-networkShare help

# Show help for a specific command in JSON format
ohos-networkShare help start --format json

# Check if network sharing is supported on this device
ohos-networkShare is-supported

# Check if network sharing is currently active
ohos-networkShare is-sharing

# Start WiFi network sharing
ohos-networkShare start --type wifi

# Start USB network sharing
ohos-networkShare start --type usb

# Start Bluetooth network sharing
ohos-networkShare start --type bluetooth

# Stop WiFi network sharing
ohos-networkShare stop --type wifi

# Stop USB network sharing
ohos-networkShare stop --type usb

# Stop Bluetooth network sharing
ohos-networkShare stop --type bluetooth

Output Format

All commands output a JSON response to stdout. Logs and debug information are output to stderr.

Success Response

{
  "type": "result",
  "status": "success",
  "data": {
    "supported": true
  }
}

Error Response

{
  "type": "result",
  "status": "failed",
  "errCode": "ERR_OPERATION_FAILED",
  "errMsg": "Permission denied. Requires ohos.permission.CONNECTIVITY_INTERNAL",
  "suggestion": "Ensure the device has network sharing capability and proper permissions."
}

Error Handling

Error Code	Description	Suggestion
ERR_OPERATION_FAILED	Operation failed	Check permissions and system configuration
ERR_MISSING_PARAM	Missing required parameter	Provide required parameters
ERR_INVALID_PARAM	Invalid parameter value	Use valid values: wifi, usb, bluetooth
INVALID_COMMAND	Unknown command	Run 'ohos-networkShare help' for available commands

Sharing Types

Type	Description	Value
wifi	WiFi hotspot sharing	0 (SharingIfaceType::SHARING_WIFI)
usb	USB tethering sharing	1 (SharingIfaceType::SHARING_USB)
bluetooth	Bluetooth PAN sharing	2 (SharingIfaceType::SHARING_BLUETOOTH)

Installation Location

The tool is installed to: /system/bin/cli_tool/executable/ohos-networkShare

Related Documentation

• OpenHarmony Network Sharing API
• Network Manager Extension Component

License

Apache License 2.0