device::gsm::pdu(3pm) [debian man page]

Device::Gsm::Pdu(3pm)					User Contributed Perl Documentation				     Device::Gsm::Pdu(3pm)

NAME

       Device::Gsm::Pdu - library to manage PDU encoded data for GSM messaging

WARNING

	  This is C<BETA> software, still needs extensive testing and
	  support for custom GSM commands, so use it at your own risk,
	  and without C<ANY> warranty! Have fun.

NOTICE

	   This module is meant to be used internally by C<Device::Gsm> class,
	   so you probably do not want to use it directly.

SYNOPSIS

	 use Device::Gsm::Pdu;

	 # DA is destination address
	 $DA = Device::Gsm::Pdu::encode_address('+39347101010');
	 $number = Device::Gsm::Pdu::decode_address( $DA );

	 # Encode 7 bit text to send messages
	 $text = Device::Gsm::Pdu::encode_text7('hello');

DESCRIPTION

       "Device::Gsm::Pdu" module includes a few basic functions to deal with SMS in PDU mode, such as encoding GSM addresses (phone numbers) and,
       for now only, 7 bit text.

FUNCTIONS

   decode_address( pdu_encoded_address )
       Takes a PDU encoded address and decodes into human-readable mobile number.  If number type is international, result will be prepended with
       a `+' sign.

       Clearly, it is intended as an internal function.

       Example

	   print Device::Gsm::Pdu::decode_address( '0B919343171010F0' );
	   # prints `+39347101010';

   encode_address( mobile_number )
       Takes a mobile number and encodes it as DA (destination address).  If it begins with a `+', as in `+39328101010', it is treated as an
       international number.

       Example

	   print Device::Gsm::Pdu::encode_address( '+39347101010' );
	   # prints `0B919343171010F0'

   encode_text7( text_string )
       Encodes some text ASCII string in 7 bits PDU format, including a header byte which tells the length is septets. This is the only 100%
       supported mode to encode text.

       Example

	   print Device::Gsm::Pdu::encode_text7( 'hellohello' );
	   # prints `0AE832...'

   pdu_to_latin1($pdu)
       Converts a PDU (without the initial length octet) into a latin1 string.

       Example

	   my $pdu = 'CAFA9C0E0ABBDF7474590E8296E56C103A3C5E97E5';
	   print Device::Gsm::Pdu::pdu_to_latin1($pdu);
	   # prints `Just another Perl hacker'

   latin1_to_pdu($text)
       Converts a text string in latin1 encoding (ISO-8859-1) into a PDU string.

       Example

	   my $text = "Just another Perl hacker";
	   print Device::Gsm::Pdu::latin1_to_pdu($text);
	   # prints `CAFA9C0E0ABBDF7474590E8296E56C103A3C5E97E5'

AUTHOR

       Cosimo Streppone, cosimo@cpan.org

COPYRIGHT

       This library is free software; you can redistribute it and/or modify it only under the terms of Perl itself.

SEE ALSO

       Device::Gsm(3), perl(1)

perl v5.14.2							    2012-03-08						     Device::Gsm::Pdu(3pm)

snmpa_mpd(3erl) 					     Erlang Module Definition						   snmpa_mpd(3erl)

NAME

       snmpa_mpd - Message Processing and Dispatch module for the SNMP agent

DESCRIPTION

       The module snmpa_mpd implements the version independent Message Processing and Dispatch functionality in SNMP for the agent. It is supposed
       to be used from a Network Interface process ( Definition of Agent Net if ).

EXPORTS

       init(Vsns) -> mpd_state()

	      Types  Vsns = [Vsn]
		     Vsn = v1 | v2 | v3

	      This function can be called from the net_if process at start-up. The options list defines which versions to use.

	      It also initializes some SNMP counters.

       process_packet(Packet, TDomain, TAddress, State, NoteStore, Log) -> {ok, Vsn, Pdu, PduMS, ACMData} | {discarded, Reason} | {discovery, Dis-
       coPacket}
       process_packet(Packet,  TDomain,  TAddress, LocalEngineID, State, NoteStore, Log) -> {ok, Vsn, Pdu, PduMS, ACMData} | {discarded, Reason} |
       {discovery, DiscoPacket}

	      Types  Packet = binary()
		     TDomain = snmpUDPDomain
		     TAddress = {Ip, Udp}
		     LocalEngineID = string()
		     Ip = {integer(), integer(), integer(), integer()}
		     Udp = integer()
		     State = mpd_state()
		     NoteStore = pid()
		     Log = snmp_log()
		     Vsn = 'version-1' | 'version-2' | 'version-3'
		     Pdu = #pdu
		     PduMs = integer()
		     ACMData = acm_data()
		     Reason = term()
		     DiscoPacket = binary()

	      Processes an incoming packet. Performs authentication and decryption as necessary. The return values should be passed the agent.

   Note:
       Note that the use of the LocalEngineID argument is only intended for special cases, if the agent is to  "emulate"  multiple  EngineIDs!	By
       default, the agent uses the value of SnmpEngineID (see SNMP-FRAMEWORK-MIB).

       generate_response_msg(Vsn, RePdu, Type, ACMData, Log) -> {ok, Packet} | {discarded, Reason}
       generate_response_msg(Vsn, RePdu, Type, ACMData, LocalEngineID, Log) -> {ok, Packet} | {discarded, Reason}

	      Types  Vsn = 'version-1' | 'version-2' | 'version-3'
		     RePdu = #pdu
		     Type = atom()
		     ACMData = acm_data()
		     LocalEngineID = string()
		     Packet = binary()

	      Generates a possibly encrypted response packet to be sent to the network. Type is the #pdu.type of the original request.

   Note:
       Note  that  the	use  of the LocalEngineID argument is only intended for special cases, if the agent is to "emulate" multiple EngineIDs! By
       default, the agent uses the value of SnmpEngineID (see SNMP-FRAMEWORK-MIB).

       generate_msg(Vsn, NoteStore, Pdu, MsgData, To) -> {ok, PacketsAndAddresses} | {discarded, Reason}
       generate_msg(Vsn, NoteStore, Pdu, MsgData, LocalEngineID, To) -> {ok, PacketsAndAddresses} | {discarded, Reason}

	      Types  Vsn = 'version-1' | 'version-2' | 'version-3'
		     NoteStore = pid()
		     Pdu = #pdu
		     MsgData = msg_data()
		     LocalEngineID = string()
		     To = [dest_addrs()]
		     PacketsAndAddresses = [{TDomain, TAddress, Packet}]
		     TDomain = snmpUDPDomain
		     TAddress = {Ip, Udp}
		     Ip = {integer(), integer(), integer(), integer()}
		     Udp = integer()
		     Packet = binary()

	      Generates a possibly encrypted request packet to be sent to the network.

	      MsgData is the message specific data used in the SNMP message. This value is received in a send_pdu or send_pdu_req message from the
	      agent.  In  SNMPv1 and SNMPv2c, this message data is the community string. In SNMPv3, it is the context information. To is a list of
	      the destination addresses and their corresponding security parameters. This value is  also  received  from  the  requests  mentioned
	      above.

   Note:
       Note  that  the	use  of the LocalEngineID argument is only intended for special cases, if the agent is to "emulate" multiple EngineIDs! By
       default, the agent uses the value of SnmpEngineID (see SNMP-FRAMEWORK-MIB).

       discarded_pdu(Variable) -> void()

	      Types  Variable = atom()

	      Increments the variable associated with a discarded pdu. This function can be used when the net_if process receives a  discarded_pdu
	      message from the agent.

Ericsson AB							     snmp 4.19							   snmpa_mpd(3erl)