org.bluez...ObjectPush(5)

📦
version 5.87 · 7 versions
, in arch rolling, nixpkgs unstable, ubuntu stonking

💖 NAME 💖

Okay bestie, welcome to org.bluez.obex.ObjectPush — it's the BlueZ D-Bus OBEX ObjectPush API documentation. This is the org.bluez...ObjectPush(5) page from the Linux System Administration manual, and it's giving very specific D-Bus energy. 🦋✨

💅 INTERFACE 💅

Here's the identity card, no cap:

🫶 Service

  • Service — org.bluez.obex

🦋 Interface

  • Interface — org.bluez.obex.ObjectPush1

🎀 Object path

  • Object path — [Session object path]

✨ METHODS ✨

These are the methods, bestie — each one returns an object, dict, and the object path is the transfer you watch. 👑

💌 object, dict SendFile(string sourcefile)

Sends local file to the remote device. 💅

The returned path represents the newly created transfer, which should be used to find out if the content has been successfully transferred or if the operation fails. 🫶

The properties of this transfer are also returned along with the object path, to avoid a call to GetProperties, see org.bluez.obex.Transfer(5) for the possible list of properties. ✨

Possible errors:

  • org.bluez.obex.Error.InvalidArguments
  • org.bluez.obex.Error.Failed

🎀 object, dict PullBusinessCard(string targetfile)

Request the business card from a remote device and store it in the local file. 💌

If an empty target file is given, a name will be automatically generated for the temporary file. 🦋

The returned path represents the newly created transfer, which should be used to find out if the content has been successfully transferred or if the operation fails. 🫶

The properties of this transfer are also returned along with the object path, to avoid a call to GetProperties, see org.bluez.obex.Transfer(5) for the possible list of properties. ✨

Possible errors:

  • org.bluez.obex.Error.InvalidArguments
  • org.bluez.obex.Error.Failed

👑 object, dict ExchangeBusinessCards(string clientfile, string targetfile)

Push the client's business card to the remote device and then retrieve the remote business card and store it in a local file. 💅

If an empty target file is given, a name will be automatically generated for the temporary file. 🦋

The returned path represents the newly created transfer, which should be used to find out if the content has been successfully transferred or if the operation fails. 🫶

The properties of this transfer are also returned along with the object path, to avoid a call to GetProperties, see org.bluez.obex.Transfer(5) for the possible list of properties. ✨

Possible errors:

  • org.bluez.obex.Error.InvalidArguments
  • org.bluez.obex.Error.Failed

Signed, sealed, and very source/version-coded: BlueZ, October 2023, on the org.bluez...ObjectPush(5) manual page. 💖🫶🎀

📦 where this page comes from