This updates the README for mmsd --- README | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 61 insertions(+), 5 deletions(-) diff --git a/README b/README index e33be69..cecc99f 100644 --- a/README +++ b/README @@ -2,20 +2,76 @@ Multimedia Messaging Service **************************** Copyright (C) 2010-2011 Intel Corporation. All rights reserved. +Updated 2021 by: Mohammad Sadiq, kent, kop316, + fuzzy7k, craftyguy, anteater +Parts adapted from: https://source.puri.sm/Librem5/purple-mm-sms + Copyright (C) 2018 Purism SPC + +About +=========================== +mmsd is a lower level daemon that transmits and recieves MMSes. It works with +both the ofono stack and the Modem Manager stack. +Please note that mmsd alone will not get MMS working! It is designed to work +with a higher level chat application to facilitate fetching and +sending MMS. It interfaces with other applications via the dbus. -Compilation and installation +Compiling mmsd ============================ - In order to compile proxy daemon you need following software packages: - GCC compiler - D-Bus library - GLib library +Installing mmsd +============================ + To configure run: - ./configure --prefix=/usr + ./bootstrap-configure --prefix=/usr/ Configure automatically searches for all required components and packages. -To compile and install run: - make && make install +To compile, run: + make + +And to Install: + make install + +mmsd will be installed in /${prefix}/libexec (if you are following this guide, +it is /usr/libexec ) + +To uninstall, simply remove the "mmsd" binary from /${prefix}/libexec or run: + sudo make uninstall + +Note that you must manually configure your favorite service manager to run +the daemon, as this installer does not configure it to autorun. + +Testing out mmsd +=========================== +To configure, run: + ./bootstrap-configure --enable-debug --enable-maintainer-mode + +Make it: + make + +Run daemon in foreground with debugging: + ./src/mmsd -n -d 'src/*' + +General Configuration +=========================== +On first run, mmsd will write a settings file at +"$HOME/.mms/$PLUGIN/mms" + +IMPORTANT NOTE: If you change settings in this file, mmsd MUST BE RESTARTED + for the changes to take effect! + +This settings file use sane defaults, but you can change them: + +UseDeliveryReports + Whether you want delivery reports for MMSes you send + +TotalMaxAttachmentSize + The maximum size all of your attachments can be before mmsd rejects it. + NOTE: This value is carrier specific! Changing this value to a higher + number may cause your carrier to silently reject MMSes you send. + CHANGE AT YOUR OWN RISK! \ No newline at end of file -- 2.30.0