/* print-camera-list - print libgphoto2 camera list in different formats
*
* Copyright 2002,2005 Hans Ulrich Niedermann <hun@users.sourceforge.net>
* Portions Copyright 2002 Lutz Mueller <lutz@users.sourceforge.net>
* Portions Copyright 2005 Julien BLACHE <jblache@debian.org>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA
*/
#define GP_USB_HOTPLUG_SCRIPT "usbcam"
/* Not sure whether this is the best possible name */
#define ARGV0 "print-camera-list"
#define HELP_TEXT \
ARGV0 " - print libgphoto2 camera list in different formats" \
"\n" \
"Syntax:\n" \
" " ARGV0 " [<options>] <FORMAT> [<format specific arguments>]\n" \
"\n" \
"Options:\n" \
" --debug print all debug output\n" \
" --help print this help message\n" \
" --verbose also print comments with camera model names\n" \
"\n" \
ARGV0 " prints the camera list in the specified format FORMAT on stdout.\n" \
"\n" \
"All other messages are printed on stderr. In case of any error, the \n" \
"program aborts regardless of data printed on stdout and returns a non-zero\n" \
"status code.\n"
#include <stdio.h>
#include <stdlib.h>
#include <sys/time.h>
#include <time.h>
#include <string.h>
#include <gphoto2/gphoto2-camera.h>
#include <gphoto2/gphoto2-port-log.h>
/* for detailed version message */
#include <gphoto2/gphoto2-version.h>
#include "config.h"
#ifndef TRUE
#define TRUE (0==0)
#endif
#ifndef FALSE
#define FALSE (0!=0)
#endif
typedef struct {
char *name;
GPVersionFunc version_func;
} module_version;
const module_version module_versions[] = {
{ "libgphoto2", gp_library_version },
{ "libgphoto2_port", gp_port_library_version },
{ NULL, NULL }
};
typedef char *string_array_t[];
typedef string_array_t *string_array_p;
typedef struct {
int number_of_cameras;
int add_comments;
int argc;
string_array_p argv;
} func_params_t;
typedef int (* begin_func_t) (const func_params_t *params,
void **data);
typedef int (* middle_func_t) (const func_params_t *params,
void **data);
typedef int (* camera_func_t) (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *ca,
void *data);
typedef int (* end_func_t) (const func_params_t *params,
void *data);
#define GP_USB_HOTPLUG_MATCH_VENDOR_ID 0x0001
#define GP_USB_HOTPLUG_MATCH_PRODUCT_ID 0x0002
#define GP_USB_HOTPLUG_MATCH_INT_CLASS 0x0080
#define GP_USB_HOTPLUG_MATCH_INT_SUBCLASS 0x0100
#define GP_USB_HOTPLUG_MATCH_INT_PROTOCOL 0x0200
#ifdef __GNUC__
#define CR(result) \
do { \
int r = (result); \
if (r < 0) { \
fprintf(stderr, ARGV0 ": " \
"Fatal error running `%s'.\n" \
"Aborting.\n", #result ); \
return (r); \
} \
} while (0)
#else /* !__GNUC__ */
#define CR(result) \
do { \
int r = (result); \
if (r < 0) { \
fprintf(stderr, ARGV0 ": " \
"Fatal error detected, aborting.\n"); \
return (r); \
} \
} while (0)
#endif /* __GNUC__ */
#define FATAL(msg...) \
do { \
fprintf(stderr, ARGV0 ": Fatal: " msg); \
fprintf(stderr, "\n"); \
exit(13); \
} while (0)
#define ASSERT(cond) \
do { \
if (!(cond)) { \
FATAL("Assertion failed: %s", #cond); \
} \
} while (0)
/* print_version_comment
* Print comment to output containing information on library versions
*
* out the file to write the comment to
* startline printed at the start of each line, e.g. "# " or " | "
* endline printed as the end of each line, e.g. "\n" or "\n"
* firstline printed before first line, e.g. NULL or "<!--+\n"
* lastline printed after last line, e.g. "\n" or " +-->\n"
*/
static void
print_version_comment(FILE *out,
const char *startline, const char *endline,
const char *firstline, const char *lastline)
{
unsigned int n;
if (out == NULL) { FATAL("Internal error: NULL out in print_version_comment()"); }
if (firstline != NULL) { fputs(firstline, out); }
if (startline != NULL) { fputs(startline, out); }
fputs("Created from this library:", out);
if (endline != NULL) { fputs(endline, out); }
for (n=0; (module_versions[n].name != NULL) && (module_versions[n].version_func != NULL); n++) {
const char *name = module_versions[n].name;
GPVersionFunc func = module_versions[n].version_func;
const char **v = func(GP_VERSION_SHORT);
unsigned int i;
if (!v) { continue; }
if (!v[0]) { continue; }
if (startline != NULL) { fputs(startline, out); }
fputs(" ", out);
fprintf(out,"%-15s %-14s ", name, v[0]);
for (i=1; v[i] != NULL; i++) {
fputs(v[i], out);
if (v[i+1] != NULL) {
fputs(", ", out);
}
}
if (endline != NULL) { fputs(endline, out); }
}
if (lastline != NULL) { fputs(lastline, out); }
}
static int
hotplug_begin_func (const func_params_t *params, void **data)
{
if (params->add_comments) {
printf("# linux-hotplug configuration file "
"for libgphoto2 supported devices\n");
print_version_comment(stdout, "# ", "\n", NULL, "#\n");
}
return 0;
}
/* print_usb_usermap
*
* Print out lines that can be included into usb.usermap
* - for all cams supported by our instance of libgphoto2.
*
* usb.usermap is a file used by
* Linux Hotplug http://linux-hotplug.sourceforge.net/
*/
static int
hotplug_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
int flags = 0;
int class = 0, subclass = 0, proto = 0;
const char *usermap_script =
((*params->argv)[0] != NULL)
?((*params->argv)[0])
:(GP_USB_HOTPLUG_SCRIPT);
if (a->port & GP_PORT_USB) {
if (a->usb_vendor) { /* usb product id may be zero! */
class = 0;
subclass = 0;
proto = 0;
flags = (GP_USB_HOTPLUG_MATCH_VENDOR_ID
| GP_USB_HOTPLUG_MATCH_PRODUCT_ID);
} else if ((a->usb_class) && (a->usb_class != 666)) {
class = a->usb_class;
subclass = a->usb_subclass;
proto = a->usb_protocol;
flags = GP_USB_HOTPLUG_MATCH_INT_CLASS;
if (subclass != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_SUBCLASS;
else
subclass = 0;
if (proto != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_PROTOCOL;
else
proto = 0;
}
} else {
/* not a USB camera */
return 0;
}
if (params->add_comments) {
printf ("# %s\n",
a->model);
}
/* The first 3 lone bytes are the device class.
* the second 3 lone bytes are the interface class.
* for PTP we want the interface class.
*/
printf ("%-20s "
"0x%04x 0x%04x 0x%04x 0x0000 "
"0x0000 0x00 0x00 "
"0x00 0x%02x 0x%02x "
"0x%02x 0x00000000\n",
usermap_script, flags,
a->usb_vendor, a->usb_product,
class, subclass, proto);
return 0;
}
static void
print_headline (void)
{
printf("No.|%-20s|%-20s|%s\n",
"camlib",
"driver name",
"camera model");
}
static void
print_hline (void)
{
printf("---+%-20s+%-20s+%s\n",
"--------------------",
"--------------------",
"-------------------------------------------");
}
static int
human_begin_func (const func_params_t *params, void **data)
{
print_hline();
print_headline();
print_hline();
return 0;
}
static int
human_end_func (const func_params_t *params, void *data)
{
print_hline();
print_headline();
return 0;
}
/** C equivalent of basename(1) */
static const char *
path_basename (const char *pathname)
{
char *result, *tmp;
/* remove path part from camlib name */
for (result=tmp=(char *)pathname; (*tmp!='\0'); tmp++) {
if ((*tmp == gp_system_dir_delim)
&& (*(tmp+1) != '\0')) {
result = tmp+1;
}
}
return (const char *)result;
}
static int
human_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
const char *camlib_basename;
camlib_basename = path_basename(a->library);
printf("%3d|%-20s|%-20s|%s\n",
i+1,
camlib_basename,
a->id,
a->model);
return 0;
}
static int
idlist_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
if (a->usb_vendor) { /* usb product id may be zero! */
printf("%04x:%04x %s\n",
a->usb_vendor,
a->usb_product,
a->model);
}
return 0;
}
typedef enum {
UDEV_PRE_0_98 = 0,
UDEV_0_98 = 1,
UDEV_136 = 2,
UDEV_175 = 3,
UDEV_201 = 4
} udev_version_t;
static const StringFlagItem udev_version_t_map[] = {
{ "pre-0.98", UDEV_PRE_0_98 },
{ "0.98", UDEV_0_98 },
{ "136", UDEV_136 },
{ "175", UDEV_175 },
{ "201", UDEV_201 },
{ NULL, 0 }
};
typedef struct {
udev_version_t version;
char *mode;
char *owner;
char *group;
char *script;
const char *begin_string;
const char *usbcam_string;
const char *usbdisk_string;
} udev_persistent_data_t;
static void
udev_parse_params (const func_params_t *params, void **data)
{
/* Note: 2 lines because we need to use || ... having them on the same
* line would mean &&.
*/
static const char * const begin_strings[] = {
/* UDEV_PRE_0_98 */
"ACTION!=\"add\", GOTO=\"libgphoto2_rules_end\"\n"
"BUS!=\"usb_device\", GOTO=\"libgphoto2_usb_end\"\n\n",
/* UDEV_0_98 */
"ACTION!=\"add\", GOTO=\"libgphoto2_rules_end\"\n"
"SUBSYSTEM!=\"usb|usb_device\", GOTO=\"libgphoto2_usb_end\"\n\n",
/* UDEV_136 */
"ACTION!=\"add\", GOTO=\"libgphoto2_rules_end\"\n"
"SUBSYSTEM!=\"usb\", GOTO=\"libgphoto2_usb_end\"\n"
"ENV{DEVTYPE}!=\"usb_device\", GOTO=\"libgphoto2_usb_end\"\n\n"
"ENV{ID_USB_INTERFACES}==\"\", IMPORT{program}=\"usb_id --export %%p\"\n"
/* ignore mass storage class having devices in mark-up */
"ENV{ID_USB_INTERFACES}==\"*:08*:*\", GOTO=\"libgphoto2_usb_end\"\n"
/* shortcut the most common camera driver, ptp class, so we avoid parsing 1000
* more rules . It will be completed in udev_begin_func() */
"ENV{ID_USB_INTERFACES}==\"*:060101:*\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"PTP\", ",
/* UDEV_175 */
"ACTION!=\"add\", GOTO=\"libgphoto2_rules_end\"\n"
"SUBSYSTEM!=\"usb\", GOTO=\"libgphoto2_usb_end\"\n"
"ENV{DEVTYPE}!=\"usb_device\", GOTO=\"libgphoto2_usb_end\"\n\n"
"ENV{ID_USB_INTERFACES}==\"\", IMPORT{builtin}=\"usb_id\"\n"
/* ignore mass storage class having devices in mark-up */
"ENV{ID_USB_INTERFACES}==\"*:08*:*\", GOTO=\"libgphoto2_usb_end\"\n"
/* shortcut the most common camera driver, ptp class, so we avoid parsing 1000
* more rules . It will be completed in udev_begin_func() */
"ENV{ID_USB_INTERFACES}==\"*:060101:*\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"PTP\", ",
/* UDEV_201 ... regular stuff is done via hwdb, only scsi generic here. */
"ACTION!=\"add\", GOTO=\"libgphoto2_rules_end\"\n"
"SUBSYSTEM!=\"usb\", GOTO=\"libgphoto2_usb_end\"\n"
"ENV{ID_USB_INTERFACES}==\"\", IMPORT{builtin}=\"usb_id\"\n"
/* shortcut the most common camera driver, ptp class, so we avoid parsing 1000
* more rules . It will be completed in udev_begin_func() */
"ENV{ID_USB_INTERFACES}==\"*:060101:*\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"PTP\", ",
};
static const char * const usbcam_strings[] = {
/* UDEV_PRE_0_98 */
"SYSFS{idVendor}==\"%04x\", SYSFS{idProduct}==\"%04x\"",
/* UDEV_0_98 */
"ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\"",
/* UDEV_136 */
"ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"proprietary\"",
/* UDEV_175 */
"ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"proprietary\"",
/* UDEV_201 */
""
};
static const char * const usbdisk_strings[] = {
/* UDEV_PRE_0_98 */
"KERNEL==\"%s\", SYSFS{idVendor}==\"%04x\", SYSFS{idProduct}==\"%04x\"",
/* UDEV_0_98 */
"KERNEL==\"%s\", ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\"",
/* UDEV_136 */
"KERNEL==\"%s\", ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"proprietary\"",
/* UDEV_175 */
"KERNEL==\"%s\", ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"proprietary\"",
/* UDEV_201 */
"KERNEL==\"%s\", ATTRS{idVendor}==\"%04x\", ATTRS{idProduct}==\"%04x\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"proprietary\""
};
udev_persistent_data_t *pdata;
pdata = calloc(1, sizeof(udev_persistent_data_t));
pdata->version = UDEV_0_98;
ASSERT(data != NULL);
*data = (void *) pdata;
if (1) {
int i;
char *key = NULL, *val = NULL;
for (i=0; ((key=(*params->argv)[i]) != NULL) &&
((val=(*params->argv)[i+1]) != NULL); i+=2) {
if (0) {
/* nothing */
} else if (strcmp("script", key)==0) {
pdata->script = val;
} else if (strcmp("owner", key)==0) {
pdata->owner = val;
} else if (strcmp("group", key)==0) {
pdata->group = val;
} else if (strcmp("version", key)==0) {
unsigned int *ver = &pdata->version;
if (gpi_string_to_enum(val, ver,
udev_version_t_map)) {
FATAL("Unrecognized udev version: \"%s\"", val);
}
} else if (strcmp("mode", key)==0) {
pdata->mode = val;
} else {
FATAL("Unknown key argument: %s", key);
}
}
if ((key != NULL) && (val == NULL)) {
FATAL("Single argument remaining; need pairs of key and value");
}
}
if ((0==0)
&& (pdata->mode == NULL)
&& (pdata->group == NULL)
&& (pdata->owner == NULL)
&& (pdata->script == NULL)
&& (pdata->version <= UDEV_0_98)) {
FATAL("Either <script> or <mode,group,owner> parameters must be given.");
}
if ((pdata->script != NULL) && (pdata->mode != NULL
|| pdata->group != NULL
|| pdata->owner != NULL)) {
FATAL("The <script> parameter conflicts with the <mode,group,owner> parameters.");
}
if (pdata->version >= UDEV_201)
fprintf(stderr,"NOTE: You need to generate a hwdb too, this file just contains the scsi generic device entries.\n");
pdata->begin_string = begin_strings[pdata->version];
pdata->usbcam_string = usbcam_strings[pdata->version];
pdata->usbdisk_string = usbdisk_strings[pdata->version];
}
static const char *
get_version_str(udev_version_t version)
{
return gpi_enum_to_string(version, udev_version_t_map);
}
static int
udev_begin_func (const func_params_t *params, void **data)
{
udev_parse_params(params, data);
if (1) {
udev_persistent_data_t *pdata = (udev_persistent_data_t *) (*data);
const char *version_str = get_version_str(pdata->version);
ASSERT(pdata != NULL);
ASSERT(version_str != NULL);
printf ("# udev rules file for libgphoto2 devices (for udev %s version)\n",
version_str);
print_version_comment(stdout, "# ", "\n", NULL, "#\n");
printf ("# this file is autogenerated, local changes will be LOST on upgrades\n");
printf ("%s", pdata->begin_string);
if (pdata->version == UDEV_136 || pdata->version == UDEV_175 || pdata->version == UDEV_201) {
if (pdata->mode != NULL || pdata->owner != NULL || pdata->group != NULL) {
if (pdata->mode != NULL) {
printf("MODE=\"%s\", ", pdata->mode);
}
if (pdata->owner != NULL) {
printf("OWNER=\"%s\", ", pdata->owner);
}
if (pdata->group != NULL) {
printf("GROUP=\"%s\", ", pdata->group);
}
}
printf ("GOTO=\"libgphoto2_usb_end\"\n\n");
}
}
return 0;
}
static int
udev_middle_func (const func_params_t *params, void **data)
{
printf ("\nLABEL=\"libgphoto2_usb_end\"\n\n");
return 0;
}
static int
udev_end_func (const func_params_t *params, void *data)
{
if (data != NULL) {
free(data);
}
printf ("\nLABEL=\"libgphoto2_rules_end\"\n");
return 0;
}
static int
udev_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
int flags = 0;
int class = 0, subclass = 0, proto = 0;
int has_valid_rule = 0;
udev_persistent_data_t *pdata = (udev_persistent_data_t *) data;
ASSERT(pdata != NULL);
if (!(a->port & GP_PORT_USB))
return 0;
if (pdata->version == UDEV_201) return 0;
if (a->usb_vendor) { /* usb product id may be zero! */
class = 0;
subclass = 0;
proto = 0;
flags = (GP_USB_HOTPLUG_MATCH_VENDOR_ID
| GP_USB_HOTPLUG_MATCH_PRODUCT_ID);
} else {
if (a->usb_class) {
class = a->usb_class;
subclass = a->usb_subclass;
proto = a->usb_protocol;
flags = GP_USB_HOTPLUG_MATCH_INT_CLASS;
if (subclass != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_SUBCLASS;
else
subclass = 0;
if (proto != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_PROTOCOL;
else
proto = 0;
}
}
if (params->add_comments) {
printf ("# %s\n", a->model);
}
if (flags & GP_USB_HOTPLUG_MATCH_INT_CLASS) {
if ((flags & (GP_USB_HOTPLUG_MATCH_INT_CLASS|GP_USB_HOTPLUG_MATCH_INT_SUBCLASS|GP_USB_HOTPLUG_MATCH_INT_PROTOCOL)) == (GP_USB_HOTPLUG_MATCH_INT_CLASS|GP_USB_HOTPLUG_MATCH_INT_SUBCLASS|GP_USB_HOTPLUG_MATCH_INT_PROTOCOL)) {
if (pdata->version == UDEV_136 || pdata->version == UDEV_175) {
printf("ENV{ID_USB_INTERFACES}==\"*:%02d%02d%02d:*\", ENV{ID_GPHOTO2}=\"1\", ENV{GPHOTO2_DRIVER}=\"PTP\"", class, subclass, proto);
} else {
printf("PROGRAM=\"check-ptp-camera %02d/%02d/%02d\"", class, subclass, proto);
}
has_valid_rule = 1;
} else {
if (class == 666) {
printf("# not working yet: PROGRAM=\"check-mtp-device\", ");
has_valid_rule = 1;
} else {
fprintf(stderr, "unhandled interface match flags %x\n", flags);
}
}
} else {
if (flags & GP_USB_HOTPLUG_MATCH_VENDOR_ID) {
printf (pdata->usbcam_string, a->usb_vendor, a->usb_product);
has_valid_rule = 1;
} else {
fprintf (stderr, "Error: Trying to output device %d/%d with incorrect match flags.\n",
a->usb_vendor, a->usb_product
);
}
}
if (has_valid_rule != 0) {
if (a->device_type & GP_DEVICE_AUDIO_PLAYER)
printf(", ENV{ID_MEDIA_PLAYER}=\"1\"");
if (pdata->script != NULL || pdata->mode != NULL || pdata->owner != NULL || pdata->group != NULL)
printf(", ");
if (pdata->script != NULL) {
printf("RUN+=\"%s\"\n", pdata->script);
} else if (pdata->mode != NULL || pdata->owner != NULL || pdata->group != NULL) {
if (pdata->mode != NULL) {
printf("MODE=\"%s\"", pdata->mode);
if (pdata->owner != NULL || pdata->group != NULL) {
printf(", ");
}
}
if (pdata->owner != NULL) {
printf("OWNER=\"%s\"", pdata->owner);
if (pdata->group != NULL) {
printf(", ");
}
}
if (pdata->group != NULL) {
printf("GROUP=\"%s\"", pdata->group);
}
printf("\n");
} else {
printf("\n");
if (pdata->version < UDEV_136)
FATAL("udev_camera_func(): illegal branch");
}
}
return 0;
}
static int
udev_camera_func2 (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
int has_valid_rule = 0;
udev_persistent_data_t *pdata = (udev_persistent_data_t *) data;
ASSERT(pdata != NULL);
if (a->port & GP_PORT_USB_DISK_DIRECT) {
printf (pdata->usbdisk_string, "sd[a-z]*",
a->usb_vendor, a->usb_product);
has_valid_rule = 1;
}
if (a->port & GP_PORT_USB_SCSI) {
printf (pdata->usbdisk_string, "sg[0-9]*",
a->usb_vendor, a->usb_product);
has_valid_rule = 1;
}
if (has_valid_rule != 0) {
if (pdata->script != NULL || pdata->mode != NULL || pdata->owner != NULL || pdata->group != NULL)
printf(", ");
if (pdata->script != NULL) {
printf("RUN+=\"%s\"\n", pdata->script);
} else if (pdata->mode != NULL || pdata->owner != NULL || pdata->group != NULL) {
if (pdata->mode != NULL) {
printf("MODE=\"%s\"", pdata->mode);
if (pdata->owner != NULL || pdata->group != NULL) {
printf(", ");
}
}
if (pdata->owner != NULL) {
printf("OWNER=\"%s\"", pdata->owner);
if (pdata->group != NULL) {
printf(", ");
}
}
if (pdata->group != NULL) {
printf("GROUP=\"%s\"", pdata->group);
}
printf("\n");
} else {
printf("\n");
if (pdata->version < UDEV_136)
FATAL("udev_camera_func(): illegal branch");
}
}
return 0;
}
static int
hwdb_begin_func (const func_params_t *params, void **data)
{
fprintf(stderr,"NOTE: You should generate a udev rules file with udev-version 201\n");
fprintf(stderr,"or later to support cameras that use SCSI tunneling support, like\n");
fprintf(stderr,"various picture frames, Olympus remote control support.\n");
printf ("# hardware database file for libgphoto2 devices\n");
return 0;
}
static int
hwdb_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
int flags = 0;
int class = 0, subclass = 0, proto = 0;
int usb_vendor = 0, usb_product = 0;
int has_valid_rule = 0;
if (!(a->port & GP_PORT_USB))
return 0;
if (a->usb_vendor) { /* usb product id may be zero! */
flags = (GP_USB_HOTPLUG_MATCH_VENDOR_ID
| GP_USB_HOTPLUG_MATCH_PRODUCT_ID);
usb_vendor = a->usb_vendor;
usb_product = a->usb_product;
} else {
if (a->usb_class) {
class = a->usb_class;
subclass = a->usb_subclass;
proto = a->usb_protocol;
flags = GP_USB_HOTPLUG_MATCH_INT_CLASS;
if (subclass != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_SUBCLASS;
else
subclass = 0;
if (proto != -1)
flags |= GP_USB_HOTPLUG_MATCH_INT_PROTOCOL;
else
proto = 0;
}
}
printf ("\n# %s\n", a->model);
if (flags & GP_USB_HOTPLUG_MATCH_INT_CLASS) {
if ((flags & (GP_USB_HOTPLUG_MATCH_INT_CLASS|GP_USB_HOTPLUG_MATCH_INT_SUBCLASS|GP_USB_HOTPLUG_MATCH_INT_PROTOCOL)) == (GP_USB_HOTPLUG_MATCH_INT_CLASS|GP_USB_HOTPLUG_MATCH_INT_SUBCLASS|GP_USB_HOTPLUG_MATCH_INT_PROTOCOL)) {
/* device class matcher ... */
/*printf("usb:v*p*d*dc%02ddsc%02dp%02d*\"\n GPHOTO2_DRIVER=PTP\n", class, subclass, proto);*/
/* but we need an interface class matcher, ptp is a interface */
printf("usb:v*ic%02disc%02dip%02d*\n GPHOTO2_DRIVER=PTP\n", class, subclass, proto);
has_valid_rule = 1;
} else {
if (class == 666) {
printf("# not working yet\n");
} else {
fprintf(stderr, "unhandled interface match flags %x\n", flags);
}
}
} else {
if (flags & GP_USB_HOTPLUG_MATCH_VENDOR_ID) {
if (strstr(a->library, "ptp"))
printf ("usb:v%04Xp%04X*\n GPHOTO2_DRIVER=PTP\n", usb_vendor, usb_product);
else
printf ("usb:v%04Xp%04X*\n GPHOTO2_DRIVER=proprietary\n", usb_vendor, usb_product);
has_valid_rule = 1;
} else {
fprintf (stderr, "Error: Trying to output device %d/%d with incorrect match flags.\n",
usb_vendor, usb_product
);
}
}
if (has_valid_rule != 0) {
printf(" ID_GPHOTO2=1\n");
if (a->device_type & GP_DEVICE_AUDIO_PLAYER)
printf(" ID_MEDIA_PLAYER=1\n");
}
return 0;
}
static int
empty_begin_func (const func_params_t *params, void **data)
{
return 0;
}
static int
empty_end_func (const func_params_t *params, void *data)
{
return 0;
}
#ifdef ENABLED_GP2DDB
static int
ddb_begin_func (const func_params_t *params, void **data)
{
printf("# Beginning of gphoto2 device database (PRE-ALPHA format!)\n\n");
print_version_comment(stdout, "# ", "\n", NULL, "\n");
return 0;
}
static int
ddb_end_func (const func_params_t *params, void *data)
{
printf("# End of gphoto2 device database (PRE-ALPHA format!).\n");
return 0;
}
static void
ddb_list_out_func(const char *str, void *data)
{
int *first = (int *)data;
printf("%s %s", (*first)?"":",", str);
*first = 0;
}
static void
ddb_delayed_head(const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
const char *camlib_basename)
{
int first = 1;
printf("# This is a PRE-ALPHA data format. Do not use it.\n\n");
if (params->add_comments) {
printf ("# %s\n", a->model);
}
printf("# automatically generated camera record %d/%d\n", i+1, total);
printf("device \"%s\" {\n", a->model);
printf(" device_type");
printf(" %s;\n", gpi_enum_to_string(a->device_type,
gpi_gphoto_device_type_map);
printf(" driver \"%s\";\n", camlib_basename);
printf(" driver_status");
printf(" %s;\n", gpi_enum_to_string(a->status,
gpi_camera_driver_status_map);
printf(" operations");
first = 1;
gpi_flags_to_string_list(a->operations,
gpi_camera_operation_map,
ddb_list_out_func,
(void *) &first);
printf(";\n");
printf(" file_operations");
first = 1;
gpi_flags_to_string_list(a->file_operations,
gpi_file_operation_map,
ddb_list_out_func,
(void *) &first);
printf(";\n");
printf(" folder_operations");
first = 1;
gpi_flags_to_string_list(a->folder_operations,
gpi_folder_operation_map,
ddb_list_out_func,
(void *) &first);
printf(";\n");
}
static int
ddb_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
const char *camlib_basename = path_basename(a->library);
int head_printed = 0;
#define DELAYED_HEAD() \
do { \
if (!head_printed) { \
ddb_delayed_head(params, i, total, \
a, camlib_basename); \
head_printed = 1; \
} \
} while (0)
if ((a->port & GP_PORT_SERIAL)) {
int first = 1;
DELAYED_HEAD();
printf(" interface serial {\n");
if (a->speed[0] != 0) {
unsigned int i;
printf(" speeds");
for (i=0;
((i < (sizeof(a->speed)/sizeof(a->speed[0]))) &&
(a->speed[i] != 0)); i++) {
printf("%s %d", (first)?"":",", a->speed[i]);
first = 0;
}
printf(";\n");
}
printf(" };\n");
}
if ((a->port & GP_PORT_USB)) {
if (a->usb_vendor) {
/* usb product id may have the legal value zero! */
DELAYED_HEAD();
printf(" interface usb {\n");
printf(" vendor 0x%04x;\n", a->usb_vendor);
printf(" product 0x%04x;\n", a->usb_product);
printf(" };\n");
}
if ((a->usb_class) && (a->usb_class != 666)) {
DELAYED_HEAD();
printf(" interface usb {\n");
printf(" class 0x%02x;\n", a->usb_class);
if (a->usb_subclass != -1) {
printf(" subclass 0x%02x;\n", a->usb_subclass);
}
if (a->usb_protocol != -1) {
printf(" protocol 0x%02x;\n", a->usb_protocol);
}
printf(" };\n");
}
}
if ((a->port & GP_PORT_DISK)) {
DELAYED_HEAD();
printf(" interface disk;\n");
}
if ((a->port & GP_PORT_PTPIP)) {
DELAYED_HEAD();
printf(" interface ptpip;\n");
}
#undef DELAYED_HEAD
if (head_printed) {
printf(" # driver_options {\n");
printf(" # option \"foo\";\n");
printf(" # option \"bar\" \"bla\";\n");
printf(" # };\n");
printf("}; # %s\n\n", a->model);
}
return 0;
}
#endif /* ENABLED_GP2DDB */
/* print_fdi_map
*
* Print FDI Device Information file for HAL with information on
* all cams supported by our instance of libgphoto2.
*
* For specs, look around on http://freedesktop.org/ and search
* for FDI on the HAL pages.
*/
static int
fdi_begin_func (const func_params_t *params, void **data)
{
printf("<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?> <!-- -*- SGML -*- -->\n");
printf("<!-- This file was generated by %s - - fdi -->\n",
"libgphoto2 " ARGV0);
print_version_comment(stdout, " | ", "\n", "<!--+\n", " +-->\n");
printf("<deviceinfo version=\"0.2\">\n");
printf(" <device>\n");
printf(" <match key=\"info.subsystem\" string=\"usb\">\n");
printf(" <!-- skip USB Mass Storage Devices -->\n");
printf(" <match key=\"usb.interface.class\" compare_ne=\"8\">\n");
return 0;
}
static int
fdi_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
char *s, *d, model[256];
if (!(a->port & GP_PORT_USB))
return 0;
s = (char *) a->model;
d = model;
while (*s && (d < &d[sizeof(d)-1])) {
if (*s == '&') {
strcpy(d,"&");
d += strlen(d);
} else {
*d++ = *s;
}
s++;
}
*d = '\0';
if ((a->port & GP_PORT_USB)) {
if (a->usb_vendor == 0x07b4 && (a->usb_product == 0x105 || a->usb_product == 0x109) ) {
/* Marcus says: The Olympus Sierra/Storage dual mode camera firmware.
* Some HAL using software gets deeply confused by this being here
* and also detected as mass storage elsewhere, so blacklist
* it here.
*/
return 0;
}
if (a->usb_vendor) { /* usb product id might be 0! */
printf(" <match key=\"usb.vendor_id\" int=\"%d\">\n", a->usb_vendor);
printf(" <match key=\"usb.product_id\" int=\"%d\">\n", a->usb_product);
if (a->usb_vendor == 0x05ac) { /* Apple iPhone, PTP user. */
printf(" <match key=\"usb.interface.class\" int=\"6\">\n");
printf(" <match key=\"usb.interface.subclass\" int=\"1\">\n");
printf(" <match key=\"usb.interface.protocol\" int=\"1\">\n");
}
if (a->device_type & GP_DEVICE_AUDIO_PLAYER) {
printf(" <merge key=\"info.category\" type=\"string\">portable_audio_player</merge>\n");
printf(" <addset key=\"info.capabilities\" type=\"strlist\">portable_audio_player</addset>\n");
printf(" <merge key=\"portable_audio_player.access_method\" type=\"string\">user</merge>\n");
printf(" <merge key=\"portable_audio_player.type\" type=\"string\">mtp</merge>\n");
/* FIXME: needs true formats ... But all of them can do MP3 */
printf(" <append key=\"portable_audio_player.output_formats\" type=\"strlist\">audio/mpeg</append>\n");
} else {
printf(" <merge key=\"info.category\" type=\"string\">camera</merge>\n");
printf(" <addset key=\"info.capabilities\" type=\"strlist\">camera</addset>\n");
/* HACK alert ... but the HAL / gnome-volume-manager guys want that */
if (NULL!=strstr(a->library,"ptp"))
printf(" <merge key=\"camera.access_method\" type=\"string\">ptp</merge>\n");
else
printf(" <merge key=\"camera.access_method\" type=\"string\">proprietary</merge>\n");
}
/* leave them here even for audio players */
printf(" <merge key=\"camera.libgphoto2.name\" type=\"string\">%s</merge>\n", model);
printf(" <merge key=\"camera.libgphoto2.support\" type=\"bool\">true</merge>\n");
if (a->usb_vendor == 0x05ac) { /* Apple iPhone */
printf(" </match>\n");
printf(" </match>\n");
printf(" </match>\n");
}
printf(" </match>\n");
printf(" </match>\n");
} else if ((a->usb_class) && (a->usb_class != 666)) {
printf(" <match key=\"usb.interface.class\" int=\"%d\">\n", a->usb_class);
printf(" <match key=\"usb.interface.subclass\" int=\"%d\">\n", a->usb_subclass);
printf(" <match key=\"usb.interface.protocol\" int=\"%d\">\n", a->usb_protocol);
printf(" <merge key=\"info.category\" type=\"string\">camera</merge>\n");
printf(" <addset key=\"info.capabilities\" type=\"strlist\">camera</addset>\n");
if (a->usb_class == 6) {
printf(" <merge key=\"camera.access_method\" type=\"string\">ptp</merge>\n");
} else {
if (a->usb_class == 8) {
printf(" <merge key=\"camera.access_method\" type=\"string\">storage</merge>\n");
} else {
printf(" <merge key=\"camera.access_method\" type=\"string\">proprietary</merge>\n");
}
}
printf(" <merge key=\"camera.libgphoto2.name\" type=\"string\">%s</merge>\n", model);
printf(" <merge key=\"camera.libgphoto2.support\" type=\"bool\">true</merge>\n");
printf(" </match>\n");
printf(" </match>\n");
printf(" </match>\n");
}
} /* camera has USB connection */
return 0;
}
static int
fdi_end_func (const func_params_t *params, void *data)
{
printf(" </match>\n");
printf(" </match>\n");
printf(" </device>\n");
printf("</deviceinfo>\n");
return 0;
}
/* print_fdi_device_map
*
* Print FDI Device Information file for HAL with information on
* all cams supported by our instance of libgphoto2.
*
* For specs, look around on http://freedesktop.org/ and search
* for FDI on the HAL pages.
*/
static int
fdi_device_begin_func (const func_params_t *params, void **data)
{
printf("<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?> <!-- -*- SGML -*- -->\n");
printf("<!-- This file was generated by %s - - fdi-device -->\n",
"libgphoto2 " ARGV0);
print_version_comment(stdout, " | ", "\n", "<!--+\n", " +-->\n");
printf("<deviceinfo version=\"0.2\">\n");
printf(" <device>\n");
printf(" <match key=\"info.subsystem\" string=\"usb\">\n");
printf(" <!-- skip USB Mass Storage Devices -->\n");
printf(" <match key=\"usb.interface.class\" compare_ne=\"8\">\n");
return 0;
}
static int
fdi_device_camera_func (const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data)
{
char *s, *d, model[256];
if (!(a->port & GP_PORT_USB))
return 0;
s = (char *) a->model;
d = model;
while (*s && (d < &d[sizeof(d)-1])) {
if (*s == '&') {
strcpy(d,"&");
d += strlen(d);
} else {
*d++ = *s;
}
s++;
}
*d = '\0';
if ((a->port & GP_PORT_USB)) {
if (a->usb_vendor == 0x07b4 && (a->usb_product == 0x105 || a->usb_product == 0x109)) {
/* Marcus says: The Olympus Sierra/Storage dual mode camera firmware.
* Some HAL using software gets deeply confused by this being here
* and also detected as mass storage elsewhere, so blacklist
* it here.
*/
return 0;
}
if (a->usb_vendor) { /* usb product id might be 0! */
/* do not set category. We don't really know what this device really is.
* But we do now that is capable of being a camera, so add to capabilities
*/
printf(" <match key=\"usb_device.vendor_id\" int=\"%d\">\n", a->usb_vendor);
printf(" <match key=\"usb_device.product_id\" int=\"%d\">\n", a->usb_product);
if (params->add_comments) {
printf(" <!-- %s -->\n", a->model);
}
if (a->device_type & GP_DEVICE_AUDIO_PLAYER)
printf(" <append key=\"info.capabilities\" type=\"strlist\">portable_audio_player</append>\n");
else
printf(" <append key=\"info.capabilities\" type=\"strlist\">camera</append>\n");
printf(" </match>\n");
printf(" </match>\n");
}
#if 0
/* would need to be able to merge upwards ... but cannot currently */
else if ((a->usb_class) && (a->usb_class != 666)) {
printf(" <match key=\"usb.interface.class\" int=\"%d\">\n", a->usb_class);
printf(" <match key=\"usb.interface.subclass\" int=\"%d\">\n", a->usb_subclass);
printf(" <match key=\"usb.interface.protocol\" int=\"%d\">\n", a->usb_protocol);
printf(" <append key=\"info.capabilities\" type=\"strlist\">camera</append>\n");
printf(" </match>\n");
printf(" </match>\n");
printf(" </match>\n");
}
#endif
}
return 0;
}
static int
fdi_device_end_func (const func_params_t *params, void *data)
{
printf(" </match>\n");
printf(" </match>\n");
printf(" </device>\n");
printf("</deviceinfo>\n");
return 0;
}
/* HTML output */
struct html_comment {
char *name;
char *comment;
};
struct html_data {
int nrofcomments;
struct html_comment *comments;
};
static int
html_begin_func (const func_params_t *params, void **data) {
FILE *f;
char buf[512];
struct html_data *hd;
printf("<!-- This part was generated by %s - - html -->\n",
"libgphoto2 " ARGV0);
print_version_comment(stdout, " | ", "\n", "<!--+\n", " +-->\n");
printf("Number of supported cameras and media players: %d\n",params->number_of_cameras);
printf("<table border=1>\n");
printf("<tr>\n");
printf(" <th>Camera Model</th>\n");
printf(" <th>Additional Abilities</th>\n");
printf(" <th>Comments</th>\n");
printf("</tr>\n");
*data = hd = malloc(sizeof(*hd));
hd->nrofcomments = 0;
hd->comments = NULL;
f = fopen("comments.txt","r");
if (!f)
return 0;
while (fgets(buf,sizeof(buf),f)) {
char *s = strchr(buf,';');
if (!s)
continue;
*s = '\0';
if (hd->nrofcomments) {
hd->comments = realloc(hd->comments, (hd->nrofcomments+1)*sizeof(hd->comments[0]));
} else {
hd->comments = malloc(sizeof(hd->comments[0]));
}
hd->comments[hd->nrofcomments].name = strdup(buf);
hd->comments[hd->nrofcomments].comment = strdup(s+1);
hd->nrofcomments++;
}
fclose (f);
return 0;
}
static char*
escape_html(const char *str) {
const char *s;
char *newstr, *ns;
int inc = 0;
s = str;
do {
s = strchr(s,'&');
if (s) {
inc+=strlen("&");
s++;
}
} while (s);
/* FIXME: if we ever get a camera with <> or so, add escape code here */
newstr = malloc(strlen(str)+1+inc);
s = str; ns = newstr;
do {
char *x;
x = strchr(s,'&');
if (x) {
memcpy (ns, s, x-s);
ns += x-s;
memcpy (ns, "&", strlen("&"));
ns += strlen("&");
s = x+1;
} else {
strcpy (ns, s);
break;
}
} while (1);
return newstr;
}
static int
html_camera_func (
const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data
) {
char *m;
int j;
CameraOperation op = a->operations;
struct html_data *hd = data;
if (a->device_type != GP_DEVICE_STILL_CAMERA)
return 0;
printf ("<tr>\n");
m = escape_html (a->model);
printf (" <td>%s</td>", m); free (m);
printf (" <td>");
if (!op) printf (" ");
if (op & GP_OPERATION_CAPTURE_IMAGE) {
printf ("Image Capture");
op &= ~GP_OPERATION_CAPTURE_IMAGE;
if (op) printf (", ");
}
if (op & GP_OPERATION_TRIGGER_CAPTURE) {
printf ("Trigger Capture");
op &= ~GP_OPERATION_TRIGGER_CAPTURE;
if (op) printf (", ");
}
if (op & GP_OPERATION_CAPTURE_PREVIEW) {
printf ("Liveview");
op &= ~GP_OPERATION_CAPTURE_PREVIEW;
if (op) printf (", ");
}
if (op & GP_OPERATION_CONFIG) {
printf ("Configuration");
op &= ~GP_OPERATION_CONFIG;
if (op) printf (", ");
}
if (op) {
printf ("Other Ops %x", op);
}
printf(" </td>");
printf(" <td>");
switch (a->status) {
case GP_DRIVER_STATUS_PRODUCTION: break;
case GP_DRIVER_STATUS_TESTING: printf("Testing (Beta)"); break;
case GP_DRIVER_STATUS_EXPERIMENTAL: printf("Experimental"); break;
case GP_DRIVER_STATUS_DEPRECATED: printf("Deprecated"); break;
}
/* read comments */
for (j=0;j<hd->nrofcomments;j++) {
if (!strcmp(a->model,hd->comments[j].name)) {
printf("%s",hd->comments[j].comment);
break;
}
}
if (j == hd->nrofcomments) printf(" ");
printf(" </td>");
printf("</tr>\n");
return 0;
}
static int html_middle_func (
const func_params_t *params,
void **data
) {
printf("</table><p>\n");
printf("Media Players that are supported by both libmtp and libgphoto2:<p/>\n");
printf("<table border=1>\n");
printf("<tr>\n");
printf(" <th>Media Player Model</th>\n");
printf("</tr>\n");
return 0;
}
static int
html_camera2_func (
const func_params_t *params,
const int i,
const int total,
const CameraAbilities *a,
void *data
) {
char *m;
if (a->device_type != GP_DEVICE_AUDIO_PLAYER)
return 0;
m = escape_html (a->model);
printf ("<tr>\n");
printf (" <td>%s</td>", m); free (m);
printf("</tr>\n");
return 0;
}
static int html_end_func (
const func_params_t *params,
void *data
) {
printf("</table>\n");
return 0;
}
/* time zero for debug log time stamps */
struct timeval glob_tv_zero = { 0, 0 };
static void
debug_func (GPLogLevel level, const char *domain, const char *str,
void *data)
{
struct timeval tv;
gettimeofday (&tv,NULL);
fprintf (stderr, "%li.%06li %s(%i): %s\n",
(long) (tv.tv_sec - glob_tv_zero.tv_sec),
(1000000L + tv.tv_usec - glob_tv_zero.tv_usec) % 1000000L,
domain, level, str);
}
typedef struct {
char *name;
char *descr;
char *help;
char *paramdescr;
begin_func_t begin_func;
camera_func_t camera_func;
middle_func_t middle_func;
camera_func_t camera_func2;
end_func_t end_func;
} output_format_t;
static int
iterate_camera_list (const int add_comments,
const output_format_t *format,
string_array_p argv)
{
int number_of_cameras;
CameraAbilitiesList *al;
CameraAbilities a;
func_params_t params;
void *data = NULL;
int ret;
CR (gp_abilities_list_new (&al));
ret = gp_abilities_list_load (al, NULL); /* use NULL context */
if (ret < GP_OK) {
gp_abilities_list_free (al);
return ret;
}
number_of_cameras = gp_abilities_list_count (al);
if (number_of_cameras < GP_OK) {
gp_abilities_list_free (al);
return ret;
}
params.add_comments = add_comments;
params.number_of_cameras = number_of_cameras;
params.argv = argv;
if (format->begin_func != NULL) {
format->begin_func(¶ms, &data);
}
if (format->camera_func != NULL) {
int i;
for (i = 0; i < number_of_cameras; i++) {
ret = gp_abilities_list_get_abilities (al, i, &a);
if (ret < GP_OK)
continue;
format->camera_func(¶ms, i, number_of_cameras, &a, data);
}
}
if (format->middle_func != NULL) {
format->middle_func(¶ms, &data);
}
if (format->camera_func2 != NULL) {
int i;
for (i = 0; i < number_of_cameras; i++) {
ret = gp_abilities_list_get_abilities (al, i, &a);
if (ret < GP_OK)
continue;
format->camera_func2(¶ms, i, number_of_cameras, &a, data);
}
}
if (format->end_func != NULL) {
format->end_func(¶ms, data);
}
CR (gp_abilities_list_free (al));
return 0;
}
/* FIXME: Add hyperlink to format documentation. */
/** list of supported output formats */
static const output_format_t formats[] = {
{"human-readable",
"human readable list of cameras",
NULL,
NULL,
human_begin_func,
human_camera_func,
NULL,
NULL,
human_end_func
},
{"usb-usermap",
"usb.usermap include file for linux-hotplug",
"If no <scriptname> is given, uses the script name "
"\"" GP_USB_HOTPLUG_SCRIPT "\".\n"
" Put this into /etc/hotplug/usb/<scriptname>.usermap",
"<NAME_OF_HOTPLUG_SCRIPT>",
hotplug_begin_func,
hotplug_camera_func,
NULL,
NULL,
empty_end_func
},
{"hal-fdi",
"fdi file for HAL",
"Put it into /usr/share/hal/fdi/information/20thirdparty/10-camera-libgphoto2.fdi",
NULL,
fdi_begin_func,
fdi_camera_func,
NULL,
NULL,
fdi_end_func
},
{"hal-fdi-device",
"fdi device file for HAL",
"Put it into /usr/share/hal/fdi/information/20thirdparty/10-camera-libgphoto2-device.fdi",
NULL,
fdi_device_begin_func,
fdi_device_camera_func,
NULL,
NULL,
fdi_device_end_func
},
{"udev-rules",
"udev rules file",
"For modes \"pre-0.98\" and \"0.98\" (and later), put it into\n"
" /etc/udev/rules.d/90-libgphoto2.rules, set file mode, owner, group\n"
" or add script to run. This rule files also uses the\n"
" check-ptp-camera script included in libgphoto2 source. Either put it to\n"
" /lib/udev/check-ptp-camera or adjust the path in the generated rules file.\n"
" If you give a script parameter, the mode, owner, group parameters will be ignored.\n"
" For mode \"136\" put it into /lib/udev/rules.d/40-libgphoto2.rules;\n"
" you can still use mode/owner/group, but the preferred mode of operation\n"
" is to use udev-extras for dynamic access permissions.\n"
" Available versions of the rule generator: 0.98, 136, 175, 201.\n",
"[script <PATH_TO_SCRIPT>|version <version>|mode <mode>|owner <owner>|group <group>]*",
udev_begin_func,
udev_camera_func,
udev_middle_func,
udev_camera_func2,
udev_end_func
},
{"hwdb",
"hardware database file",
"Put it into /usr/lib/udev/hwdb.d/20-gphoto.conf.\n",
NULL,
hwdb_begin_func,
hwdb_camera_func,
NULL,
NULL,
empty_end_func
},
{"html",
"HTML table file for gphoto.org website",
"Paste it into /proj/libgphoto2/support.php",
NULL,
html_begin_func,
html_camera_func,
html_middle_func,
html_camera2_func,
html_end_func
},
{"idlist",
"list of IDs and names",
"grep for an ID to find the device name",
NULL,
empty_begin_func,
idlist_camera_func,
NULL,
NULL,
empty_end_func
},
#ifdef ENABLED_GP2DDB
{"gp2ddb",
"gphoto2 device database (PRE-ALPHA)",
"PRE-ALPHA test stage, do not use for production! Machine parseable.",
NULL,
ddb_begin_func,
ddb_camera_func,
NULL,
NULL,
ddb_end_func
},
#endif
{NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL}
};
/** \brief print list of output formats with descriptions
*/
static int print_format_list(const output_format_t *formats)
{
int i;
printf("List of output formats:\n");
for (i=0; formats[i].name != NULL; ++i) {
if (formats[i].paramdescr != NULL) {
printf(" %s %s\n %s\n",
formats[i].name,
formats[i].paramdescr,
formats[i].descr);
} else {
printf(" %s\n %s\n",
formats[i].name, formats[i].descr);
}
if (formats[i].help != NULL) {
printf(" %s\n", formats[i].help);
}
}
return 0;
}
/** \brief print program help
*/
static int print_help()
{
puts(HELP_TEXT);
return print_format_list(formats);
}
/** \brief main program: parse and check arguments, then delegate the work
*/
int main(int argc, char *argv[])
{
int add_comments = FALSE; /* whether to add cam model as a comment */
int debug_mode = FALSE; /* whether we should output debug messages */
char *format_name = NULL; /* name of desired output format */
int format_index; /* index number of (desired) output format */
static char *fmt_argv[16]; /* format specific arguments */
int i, j;
unsigned int ui;
/* initialize parameters to NULL */
for (ui=0; ui<(sizeof(fmt_argv)/sizeof(fmt_argv[0])); ui++) {
fmt_argv[ui] = NULL;
}
/* walk through command line arguments until format is encountered */
for (i=1; (i<argc) && (format_name == NULL); i++) {
if (0 == strcmp(argv[i], "--verbose")) {
if (add_comments) {
fprintf(stderr, "Error: duplicate parameter: option \"%s\"\n", argv[i]);
return 1;
}
add_comments = TRUE;
} else if (0 == strcmp(argv[i], "--debug")) {
if (debug_mode) {
fprintf(stderr, "Error: duplicate parameter: option \"%s\"\n", argv[i]);
return 1;
}
debug_mode = TRUE;
/* now is time zero for debug log time stamps */
gettimeofday (&glob_tv_zero, NULL);
gp_log_add_func (GP_LOG_ALL, debug_func, NULL);
} else if (0 == strcmp(argv[i], "--help")) {
return print_help();
} else {
format_name = argv[i];
}
}
/* walk through output format list, searching for the requested one */
if (format_name == NULL) {
return print_help();
}
format_index=0;
while (formats[format_index].name != NULL) {
if (strcmp(formats[format_index].name, format_name) == 0) {
break;
}
format_index++;
}
if ((formats[format_index].name == NULL) ||
(strcmp(formats[format_index].name, format_name) != 0)) {
return print_help();
}
/* copy remaining arguments */
for (j=i;
(j<argc) && ((j-i)<(int)((sizeof(fmt_argv)/sizeof(fmt_argv[0]))-1));
j++) {
fmt_argv[j-i] = argv[j];
}
/* execute the work using the given parameters*/
return iterate_camera_list(add_comments, &formats[format_index],
&fmt_argv
);
}
/*
* Local Variables:
* c-file-style:"linux"
* indent-tabs-mode:t
* End:
*/