set pmodem
Purpose
Used to configure various options for modem emulation over TCP/IP, and display current modem-emulation settings.
Required permissions
For Digi products with two or more users, to use this command, permissions must be set to one of the following:
- For a user to display the modem emulation settings for the line on which they are logged in: set permissions s-pmodem=r-self.
- For a user to display the modem emulation settings for any line: set permissions s-pmodem=read.
- For a user to display and set the modem emulation settings for the line on which they are logged in: set permissions s-pmodem=rw-self.
- For a user to display the modem emulation settings for any line, and set modem emulation settings for the line on which the user is logged in: set permissions s-pmodem=w-self-r.
- For a user to display and set the modem emulation settings on any line: set permissions s-pmodem=rw.
See set permissions for details on setting user permissions for commands.
Syntax
Configure modem emulation
set pmodem [port=range]
[state={on|off}]
[telnet={on|off}
[ssl={on|off}]
[auth={none|server|both}](used with “ssl=on” option only)
The connection-type options telnet and ssl apply to both incoming and outgoing calls via the pmodem feature. Only one of these options can be enabled at once, though all these options can be off.
Display modem-emulation settings
set pmodem [port=range]
Options
port=range
Used to specify the serial port. Optional on a single-port device.
state={on|off}
Used to enable or disable modem emulation on a given serial port.
on
Enables modem emulation.
off
Disables modem emulation.
The default is off.
telnet
Enables or disables Telnet processing on incoming and outgoing modem-emulation connections.
on
Enables Telnet processing.
off
Disables Telnet processing.
The default is off.
ssl={on|off}
Enables or disables SSL processing on incoming and outgoing modem-emulation connections
on
Enables SSL processing.
off
Disables SSL processing.
The default is off.
auth={none|server|both} (used with “ssl=on” option only)
Selects the authentication model when SSL is the enabled connection type (ssl=on).
none
No active verification of any peer’s certificates. As a client, the Digi device presents a certificate if one is requested, but it will not validate a server certificate. As a server, the Digi device present its certificate, but does not request or validate a client certificate.
server
The Digi device actively verifies only server certificates. As a client, the Digi device verifies the server certificate if one is presented to it, and presents a certificate if one is requested. As a server, the Digi device presents its certificate, but does not request or validate a client certificate.
both
The Digi device actively verifies client and server certificates. As a client, the Digi device verifies the server certificate, and presents a certificate if one is requested. As a server, the Digi device presents its certificate, requests a client certificate, then validates the certificate.
Example
#> set pmodem port=1 state=on
See also
- certmgmt for additional information on managing certificates.
- revert: The revert pmodem command reverts the settings configured by this command.
- set network
- set profile
- show: The show pmodem command shows the current modem emulation settings in a Digi device.
- Chapter 3, Modem Emulation AT Command Set for descriptions of Digi-specific commands for modem-emulation configurations.