K3765-Z_UNLOCK(8) K3765-Z_UNLOCK(8) NAME k3765-z_unlock - unlocks SIM card on K3765-Z USB broadband modem SYNOPSIS k3765-z_unlock [-force] DESCRIPTION This is a script to unlock the SIM card on a broadband (GPRS, UMTS) modem contained in a USB device after connecting it. It is designed and tested for the model "K3765-Z" (as distributed by Vodafone). Arguments: -force Perform or initiate operation independent on the result of pre‐ vious runs. Permanent Lock Prevention Care must be taken to not repeatedly send wrong PINs to the device, because usually the SIM locks after the 3rd unsuccessful attempt, and then requires a PUK to be usable again. Therefore no operations will be done until the sequence is started man‐ ually by a successful run using the -force option, and are kept until any error occurs, then switching to the inactive state again. Exit status: 0 if OK, 1 if the runtime directory is not present, 2 if the control file can not be deleted (override with option -force), 3 if the last run was not successful or running the first time without -force (this behaviour is intentional to prevent perma‐ nent lock of the SIM card), 4 if the expected character device is not present (usually means that the adapter is not plugged in), 5 on error while sending the PIN to the device. FILES Note: Paths may be different dependent on local installation. /var/run/k3765-z_unlock/accepted Controls whether more PINs should be attempted to be send to the modem -- this is the case if present. Then it contains informa‐ tion about whether a PIN was required on the last run. If not present either the command did never run, or an error occurred the last time, preventing more attempts to avoid permanent lock. /etc/udev/rules.d/51_vmc_zte_local.rules Udev rules file. AUTHOR Written by Gero Treuner (www.70t.de). COPYRIGHT Copyright © 2011 Gero Treuner License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. SEE ALSO The full documentation is in the README file. UDEV(7), chat(8). SIM Unlocker September 2011 K3765-Z_UNLOCK(8)