comparison doc/User-oriented-commands @ 89:629be330f92b

doc/User-oriented-commands: pb-restore documented
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 17 Feb 2021 17:39:26 +0000
parents 4558048fce10
children 8a714fe98aa9
comparison
equal deleted inserted replaced
88:ae831b21ef77 89:629be330f92b
232 pb-dump-rec PBNAME start-rec end-rec 232 pb-dump-rec PBNAME start-rec end-rec
233 233
234 This command dumps the specified range of records from a potentially large 234 This command dumps the specified range of records from a potentially large
235 phonebook. 235 phonebook.
236 236
237 pb-restore PBNAME filename
238
239 This command reads a phonebook data file in the format described in the
240 SIM-data-formats document and uploads it into the named SIM phonebook. Every
241 record in the SIM phonebook is overwritten with an UPDATE RECORD command; those
242 record indices which do not appear in the data file being restored get blank
243 records (0xFF in every byte) written into them.
244
237 pb-update PBNAME filename 245 pb-update PBNAME filename
238 246
239 This command reads a phonebook data file in the format described in the 247 This command reads a phonebook data file in the format described in the
240 SIM-data-formats document and uploads it into the named SIM phonebook, writing 248 SIM-data-formats document and uploads it into the named SIM phonebook, writing
241 each record from the data file into the SIM with an UPDATE RECORD command. 249 only those record indices which appear in the data file - each record from the
242 250 data file gets written into the SIM with an UPDATE RECORD command, while all
243 Please note that this command does NOT include a built-in erase of those SIM 251 other record locations remain untouched.
244 phonebook record positions which are not covered by the data file being uploaded
245 - any non-blank records in those positions will retain their previous content.
246 252
247 pb-update-imm PBNAME rec phone-number [alpha-tag] 253 pb-update-imm PBNAME rec phone-number [alpha-tag]
248 254
249 This command writes a single phonebook entry directly from the command line, 255 This command writes a single phonebook entry directly from the command line,
250 without going through a data file. The specific record index to write into must 256 without going through a data file. The specific record index to write into must