dist/Clients/dnssdutil.c

235 // Help text for record data options
244 	"A record data argument is specified in one of the following formats:\n"											\
249 	"TXT record keys and values       txt:<comma-delimited keys and values>  txt:'key1=x,key2=y\\,z,key3'\n"			\
250 	"File containing raw record data  file:<file path>                       file:dir/record_data.bin\n"
333 	StringOption( 'n', "name", &gQueryRecord_Name, "domain name", "Full domain name of record to query.", true ),
334 	StringOption( 't', "type", &gQueryRecord_Type, "record type", "Record type by name (e.g., TXT, SRV, etc.) or number.", true ),
351 	IntegerOption( 'l', "timeLimit",	&gQueryRecord_TimeLimitSecs,	"seconds", "Maximum duration of the query record operation. Use '0' for no time limit.", false ),
352 	BooleanOption(  0 , "raw",			&gQueryRecord_RawRData,			"Show record data as a hexdump." ),
385 	StringOption(   0 , "txt",		&gRegister_TXT,		"record data",	"The TXT record data. See " kRecordDataSection_Name " below.", false ),
395 	CLI_OPTION_GROUP( "Options for updating the registered service's primary TXT record with DNSServiceUpdateRecord()\n" ),
396 	StringOption(  0 , "updateData",	&gUpdateRecord_Data,	"record data",	"Record data for the record update. See " kRecordDataSection_Name " below.", false ),
397 	IntegerOption( 0 , "updateDelay",	&gUpdateRecord_DelayMs,	"ms",			"Number of milliseconds after registration to wait before record update.", false ),
398 	IntegerOption( 0 , "updateTTL",		&gUpdateRecord_TTL,		"seconds",		"Time-to-live of the updated record.", false ),
400 	CLI_OPTION_GROUP( "Options for adding extra record(s) to the registered service with DNSServiceAddRecord()\n" ),
401 	MultiStringOption(   0 , "addType",	&gAddRecord_Types,	&gAddRecord_TypesCount,	"record type",	"Type of additional record by name (e.g., TXT, SRV, etc.) or number.", false ),
402 	MultiStringOptionEx( 0 , "addData",	&gAddRecord_Data,	&gAddRecord_DataCount,	"record data",	"Additional record's data. See " kRecordDataSection_Name " below.", false, NULL ),
403 	MultiStringOption(   0 , "addTTL",	&gAddRecord_TTLs,	&gAddRecord_TTLsCount,	"seconds",		"Time-to-live of additional record in seconds. Use '0' for default.", false ),
425 	StringOption( 'n', "name",	&gRegisterRecord_Name,	"record name",	"Fully qualified domain name of record.", true ),
426 	StringOption( 't', "type",	&gRegisterRecord_Type,	"record type",	"Record type by name (e.g., TXT, PTR, A) or number.", true ),
427 	StringOption( 'd', "data",	&gRegisterRecord_Data,	"record data",	"The record data. See " kRecordDataSection_Name " below.", false ),
439 	CLI_OPTION_GROUP( "Options for updating the registered record with DNSServiceUpdateRecord()\n" ),
440 	StringOption(  0 , "updateData",	&gRegisterRecord_UpdateData,	"record data",	"Record data for the record update.", false ),
441 	IntegerOption( 0 , "updateDelay",	&gRegisterRecord_UpdateDelayMs,	"ms",			"Number of milliseconds after registration to wait before record update.", false ),
442 	IntegerOption( 0 , "updateTTL",		&gRegisterRecord_UpdateTTL,		"seconds",		"Time-to-live of the updated record.", false ),
490 	StringOption( 'n', "name",	&gReconfirmRecord_Name,		"record name",	"Full name of the record to reconfirm.", true ),
491 	StringOption( 't', "type",	&gReconfirmRecord_Type,		"record type",	"Type of the record to reconfirm.", true ),
492 	StringOption( 'c', "class",	&gReconfirmRecord_Class,	"record class",	"Class of the record to reconfirm. Default class is IN.", false ),
493 	StringOption( 'd', "data",	&gReconfirmRecord_Data,		"record data",	"The record data. See " kRecordDataSection_Name " below.", false ),
574 	IntegerOption( 'l', "timeLimit",	&gReverseLookup_TimeLimitSecs,	"seconds", "Specifies the max duration of the query record operation. Use '0' for no time limit.", false ),
660 	BooleanOption(  0 , "raw",			&gDNSQuery_RawRData,		"Present record data as a hexdump." ),
687 	BooleanOption(  0 , "raw",			&gDNSCrypt_RawRData,		"Present record data as a hexdump." ),
714 	BooleanOption(  0 , "raw",			&gMDNSQuery_RawRData,		"Present record data as a hexdump." ),
769 	Command( "queryRecord",			QueryRecordCmd,			kQueryRecordOpts,		"Uses DNSServiceQueryRecord() to query for an arbitrary DNS record.", false ),
771 	Command( "registerRecord",		RegisterRecordCmd,		kRegisterRecordOpts,	"Uses DNSServiceRegisterRecord() to register a record.", false ),
773 	Command( "reconfirm",			ReconfirmCmd,			kReconfirmOpts,			"Uses DNSServiceReconfirmRecord() to reconfirm a record.", false ),
1046 	BrowseResolveOp *		resolveList;		// List of resolve and/or TXT record query operations.
1459 		FPrintF( stdout, " TXT record: %#H\n", inTXTPtr, (int) inTXTLen, INT_MAX );
1463 		FPrintF( stdout, " TXT record: %#{txt}\n", inTXTPtr, (size_t) inTXTLen );
1724 	const char *		recordName;		// Resource record name argument for DNSServiceQueryRecord().
1728 	uint16_t			recordType;		// Resource record type argument for DNSServiceQueryRecord().
1731 	Boolean				gotRecord;		// True if in one-shot mode and received at least one record of the desired type.
1804 	// Get record type.
1985 	uint8_t *			txtPtr;				// Service TXT record data. (malloc'd)
1986 	size_t				txtLen;				// Service TXT record data len.
1989 	uint8_t *			updateTXTPtr;		// Pointer to record data for TXT record update. (malloc'd)
1990 	size_t				updateTXTLen;		// Length of record data for TXT record update.
1991 	uint32_t			updateTTL;			// TTL of updated TXT record.
1992 	int					updateDelayMs;		// Post-registration TXT record update delay in milliseconds.
1995 	int					lifetimeMs;			// Lifetime of the record registration in milliseconds.
2044 		FPrintF( stderr, "There are missing additional record parameters.\n" );
2058 	// Get TXT record data.
2158 		FPrintF( stdout, "\nUpdate record:\n" );
2167 		const ExtraRecord *		record = &inContext->extraRecords[ i ];
2169 		FPrintF( stdout, "Extra record %zu:\n",		i + 1 );
2170 		FPrintF( stdout, "    Type:  %s (%u)\n",	RecordTypeToString( record->type ), record->type );
2171 		FPrintF( stdout, "    TTL:   %u%?s\n",		record->ttl, record->ttl == 0, " (system will use a default value.)" );
2172 		FPrintF( stdout, "    RData: %#H\n\n",		record->dataPtr, (int) record->dataLen, INT_MAX );
2184 	ExtraRecord *					record;
2189 	for( record = inContext->extraRecords; record < end; ++record )
2191 		check( !record->recordRef );
2192 		ForgetMem( &record->dataPtr );
2248 			ExtraRecord *					record;
2251 			for( record = context->extraRecords; record < end; ++record )
2253 				err = DNSServiceAddRecord( context->opRef, &record->recordRef, 0, record->type,
2254 					(uint16_t) record->dataLen, record->dataPtr, record->ttl );
2298 	DNSRecordRef		recordRef;		// Registered record reference.
2299 	const char *		recordName;		// Name of resource record.
2300 	uint8_t *			dataPtr;		// Pointer to resource record data.
2301 	size_t				dataLen;		// Length of resource record data.
2302 	uint32_t			ttl;			// TTL value of resource record in seconds.
2305 	int					lifetimeMs;		// Lifetime of the record registration in milliseconds.
2306 	uint16_t			recordType;		// Resource record type.
2307 	uint8_t *			updateDataPtr;	// Pointer to data for record update. (malloc'd)
2308 	size_t				updateDataLen;	// Length of data for record update.
2309 	uint32_t			updateTTL;		// TTL for updated record.
2310 	int					updateDelayMs;	// Post-registration record update delay in milliseconds.
2311 	Boolean				didRegister;	// True if the record was registered.
2358 	// Get record type.
2363 	// Get record data.
2433 		FPrintF( stdout, "\nUpdate record:\n" );
2669 	// Get record type.
2674 	// Get record data.
2682 	// Get record data.
2779 		FPrintF( stdout, " TXT record: %#H\n", inTXTPtr, (int) inTXTLen, INT_MAX );
2783 		FPrintF( stdout, " TXT record: %#{txt}\n", inTXTPtr, (size_t) inTXTLen );
2944 	// Create reverse lookup record name.
3842 					FPrintF( stdout, "%*s" "TXT record:\n", Indent( 3 ) );
5140 		FPrintF( stderr, "TXT record length is too short (%u < %u)\n", txtLen, kDNSCryptCertMinimumLength + 1 );
5146 		FPrintF( stderr, "TXT record value length is too short (%u < %u)\n", txtPtr[ 0 ], kDNSCryptCertMinimumLength );
5510 	const char *			qnameStr;							// Name (QNAME) of the record being queried as a C string.
5516 	uint16_t				qtype;								// The type (QTYPE) of the record being queried.
6142 		FPrintF( stderr, "Unrecognized record data string \"%s\".\n", inString );
6486 	const DNSRecordFields *		record;
6493 	record = (DNSRecordFields *) ptr;
6494 	rdLength = ReadBig16( record->rdLength );
6495 	require_action_quiet( (size_t)( msgEnd - record->rdata ) >= rdLength , exit, err = kUnderrunErr );
6497 	if( outType )		*outType		= ReadBig16( record->type );
6498 	if( outClass )		*outClass		= ReadBig16( record->class );
6499 	if( outTTL )		*outTTL			= ReadBig32( record->ttl );
6500 	if( outRDataPtr )	*outRDataPtr	= record->rdata;
6502 	if( outPtr )		*outPtr			= record->rdata + rdLength;