base-modem: new port getters and peekers

 * mm_base_modem_peek_port_* () will return either a port object (no new
reference), or NULL if none available.

You would usually peek() a port if you're going to use it just in the current
method, as there is no way to that reference to get invalid (we're single
threaded).

 * mm_base_modem_get_port_* () will return either NEW references to valid
port objects, or NULL if none available.

And, you would usually get() a port, whenever you want the port object to be
valid even out of the current method, for example when keeping it in the
context of an async operation.

Also, we need to consider that the primary AT port MAY BE NULL when you
peek() or get() it. This is due to the fact that we may be releasing ports
(due to device disconnection) in the middle of async operations.

1 files changed, 14 insertions, 6 deletions

diff --git a/src/mm-base-modem.h b/src/mm-base-modem.h
index b572cf87..4318de3a 100644
--- a/src/mm-base-modem.h
+++ b/src/mm-base-modem.h
@@ -114,12 +114,20 @@ gboolean  mm_base_modem_owns_port    (MMBaseModem *self,
 gboolean  mm_base_modem_organize_ports (MMBaseModem *self,
                                         GError **error);
 
-MMAtSerialPort   *mm_base_modem_get_port_primary   (MMBaseModem *self);
-MMAtSerialPort   *mm_base_modem_get_port_secondary (MMBaseModem *self);
-MMQcdmSerialPort *mm_base_modem_get_port_qcdm      (MMBaseModem *self);
-MMPort           *mm_base_modem_get_best_data_port (MMBaseModem *self);
-MMAtSerialPort   *mm_base_modem_get_best_at_port   (MMBaseModem *self,
-                                                    GError **error);
+MMAtSerialPort   *mm_base_modem_peek_port_primary   (MMBaseModem *self);
+MMAtSerialPort   *mm_base_modem_peek_port_secondary (MMBaseModem *self);
+MMQcdmSerialPort *mm_base_modem_peek_port_qcdm      (MMBaseModem *self);
+MMAtSerialPort   *mm_base_modem_peek_best_at_port   (MMBaseModem *self,
+                                                     GError **error);
+MMPort           *mm_base_modem_peek_best_data_port (MMBaseModem *self);
+
+MMAtSerialPort   *mm_base_modem_get_port_primary    (MMBaseModem *self);
+MMAtSerialPort   *mm_base_modem_get_port_secondary  (MMBaseModem *self);
+MMQcdmSerialPort *mm_base_modem_get_port_qcdm       (MMBaseModem *self);
+MMAtSerialPort   *mm_base_modem_get_best_at_port    (MMBaseModem *self,
+                                                     GError **error);
+MMPort           *mm_base_modem_get_best_data_port  (MMBaseModem *self);
+
 
 void     mm_base_modem_set_valid    (MMBaseModem *self,
                                      gboolean valid);