unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




 NAME
      rpcprofile - A dcecp object that manages an RPC profile entry in CDS

 SYNOPSIS
      rpcprofile add profile_name_list -member member_name_list
      {-interface interface_id [-priority priority] [-annotation annotation]
      |
      -default}

      rpcprofile create profile_name_list

      rpcprofile delete profile_name_list

      rpcprofile help [operation | -verbose]

      rpcprofile import profile_name_list -interface interface_id
      [-object object_uuid]  [-max integer] [-noupdate]

      rpcprofile list profile_name_list [-member member_name_list]
      [-noupdate]

      rpcprofile operations

      rpcprofile remove profile_name_list
      {-default | -member member_name -interface interface_id |
      -annotation annotation | -priority priority}

      rpcprofile show profile_name_list
      {-default | [-member member_name] [-interface interface_id]
      [-version versions] [-priority priority] [-annotation annotation]
      [-noupdate]}


 ARGUMENTS
      operation The name of the rpcprofile operation for which to display
		help information.

      profile_name_list
		Specifies a list of one or more names of the RPC profile
		entries to be operated on.


 DESCRIPTION
      The rpcprofile object represents a remote procedure call (RPC) profile
      entry in the Cell Directory Service (CDS).  Each operation described
      below, except help and operations, takes as an argument a list of one
      or more names of RPC profiles to be operate on.  An RPC profile
      consists of members (also known as elements in other DCE
      documentation). A member can be either RPC server entries, RPC groups,
      or other RPC profiles; therefore each member of a profile has a name
      in the DCE namespace.  Each profile can also have one default member



 Hewlett-Packard Company	    - 1 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      (called the default profile element).

      A profile entry contains no attributes, but does contain information
      about each member that is not contained in the member itself.  The
      information stored for each member includes up to four fields of
      information consisting of interface and version, a member name, a
      priority (0 through 7), and an annotation.  For example:

      {{d46113d0-a848-11cb-b863-08001e046aa5 2.0} /.../gumby1/sec 0 rs_bind}


      Various rpcprofile operations have options that correspond to the
      fields of information contained in profile members. Specifically, the
      options are -interface, -member, -priority, and -annotation.

 DATA STRUCTURES
      interface_id
		The interface identifier of an RPC interface.  The interface
		identifier takes the following form:

		interface-uuid,major-version.minor-version

		The version numbers are optional, but if you omit a version
		number, the value defaults to 0. The UUID is a hexadecimal
		string and the complete version number is a decimal string.
		For example:

		-interface ec1eeb60-5943-11c9-a309-08002b102989,3.11

		Leading zeros in version numbers are ignored.

		Alternatively, you can use Tcl syntax in the following form:

		{interface-UUID major-version.minor-version}

		For example:

		-interface {458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0}



      object_uuid
		The UUID of an object.	The UUID is a hexadecimal string,
		for example:

		-object 3c6b8f60-5945-11c9-a236-08002b102989


		Alternatively, you can use Tcl syntax.	For example:

		-object {3c6b8f60-5945-11c9-a236-08002b102989}



 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      host_address
		An RPC string binding that describes a host's location.	 The
		binding information contains an RPC protocol and the host's
		network address.  Any specific host's network address can be
		obtained by using the getip command.

      annotation
		An informational text string that helps you to identify the
		purpose of the profile element.	 Use single or double
		quotation marks around the annotation field of profile
		elements to include internal spaces in an annotation, for
		example:

		-annotation "Bulletin Board Server, Version 1.3a"


		Alternatively, you can use Tcl syntax.	For example:

		-annotation {Bulletin Board Server, Version 1.3a}


      version	Specifies which interface version numbers to return with a
		show operation.	 Specify versions by using one of the
		following values for the -version option:


		all	  The interface version is ignored.

		exact	  Both the major and minor versions must match the
			  specified versions.

		compatible
			  The major version must match the specified
			  version, and the minor version must be greater
			  than or equal to the specified version.

		major_only
			  The major version must match the specified
			  version; the minor version is ignored.

		upto	  The major version must be less than or equal to
			  that specified. If the major versions are equal,
			  the minor version must be less than or equal to
			  that specified.


		If the -version option is absent, the command shows
		compatible version numbers.






 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




 OPERATIONS
    rpcprofile add
      Adds a member to the specified profile entry in CDS. The syntax is as
      follows:

      rpcprofile add profile_name_list -member member_name_list
      {-interface interface_id [-priority priority] [-annotation annotation]
      |
      -default}


      Options

      -member member_name_list
		This required option declares the name of a member to be
		added to the specified profile entry.  The member_name_list
		argument is a list of names of one or more members to be
		added to all of the specified profiles.

      -interface interface_id
		Required when the -default option is not used, this option
		declares the interface identifier of an RPC interface.	The
		add operation operates on only one interface_id.

		See DATA STRUCTURES for the format of an interface
		identifier.

      -priority priority
		Defines a search priority for the new profile element.	The
		priority value is in the range 0 to 7 with zero having the
		highest priority. By default, a nondefault element is
		assigned a priority value of zero.

      -annotation annotation
		Defines an annotation string for the profile element.  You
		can include internal spaces in an annotation by enclosing
		the string in quotation marks.

      -default	Performs the operation on the default profile member.  When
		you use the -default option, all of the other options except
		-member are illegal.


      The add operation adds a member to the specified profile entry in CDS.
      The profile_name_list argument is a list of names of RPC profiles to
      have members added to.  The value of the required -member option is a
      list of names which are references to an RPC entry, RPC group, or RPC
      profile (that is, they do not have to actually exist).

      The operation accepts the -interface, -priority, and -annotation
      options with one value (not a list) each. All members are added to



 Hewlett-Packard Company	    - 4 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      each profile identified in the argument list.  It also accepts a
      -default option to indicate that the member being added is the default
      profile member.  (If you specify the -default option, the only other
      option that can be supplied is -member.)	This operation returns an
      empty string on success.	If member_name_list contains the names of
      duplicate or existing members, the duplicates are ignored, and no
      errors are generated.

      Privileges Required

      You need i (insert) permission to the parent directory. You also need
      both r (read) permission and w (write) permission to the CDS object
      entry (the target profile entry).

      Examples

      The following command adds an element to the cell profile, /.:/cell-
      profile, in the local cell:

      dcecp> rpcprofile add /.:/cell-profile \
      > -member /.:/Calendar_profile  \
      > -interface ec1eeb60-5943-11c9-a309-08002b102989,1.1  \
      > -annotation RefersToCalendarGroups
      dcecp>


      The following commands set up a user profile associated with the cell
      profile as its default element and adds a user-specific element for
      the Calendar V1.1 interface:

      dcecp> rpcprofile add /.:/LandS/anthro/molly_o_profile -default /.:/cell-profile
      dcecp>

      dcecp> rpcprofile add /.:/LandS/anthro/molly_o_profile \
      > -member {/.:/LandS/anthro/Calendar_group} \
      > -interface {ec1eeb60-5943-11c9-a309-08002b102989 1.1} \
      > -annotation {Calendar_Version 1.1_Interface}
      dcecp>


      The added profile element contains the global name of the member
      (specified by using its cell-relative name,
      /.:/LandS/anthro/Calendar_group) and the RPC interface identifier for
      the Calendar Version 1.1 interface.

    rpcprofile create
      Creates a new profile entry in CDS.  The syntax is as follows:

      rpcprofile create profile_name_list





 Hewlett-Packard Company	    - 5 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      The create operation creates a new (empty) profile entry in CDS. Since
      an empty profile is the same as an empty RPC entry or RPC group,
      calling rpcprofile create is the same as calling rpcentry create or
      rpcgroup create.	The profile_name_list argument is a list of names of
      RPC profiles to be created. This operation returns an empty string on
      success.	If the RPC profile already exists, an error is returned.

      Privileges Required

      You need i (insert) permission to the parent directory. You also need
      both r (read) permission and w (write) permission to the CDS object
      entry (the target profile entry).

      Examples

      dcecp>&gt&gt> rpcprofile create /.:/users/wards_profile
      dcecp>&gt&gt>


    rpcprofile delete
      Deletes the specified profile from CDS.  The syntax is as follows:

      rpcprofile delete profile_name_list


      The delete operation deletes the specified profile from CDS.  The
      profile_name_list argument is a list of names of RPC profiles to be
      deleted.	This operation returns an empty string on success.  If the
      RPC profile does not exist, an error is returned.

      Privileges Required

      You need w (write) permission to the CDS object entry (the target
      profile entry).

      Examples

      The following command deletes the profile named
      /.:/LandS/anthro/molly_o_profile:

      dcecp> rpcprofile delete /.:/LandS/anthro/molly_o_profile
      dcecp>


    rpcprofile help
      Returns help information about the rpcprofile object and its
      operations. The syntax is as follows:

      rpcprofile help [operation | -verbose]





 Hewlett-Packard Company	    - 6 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      Options

      -verbose	Displays information about the rpcprofile object.


      Used without an argument or option, the rpcprofile help command
      returns brief information about each rpcprofile operation. The
      optional operation argument is the name of an operation about which
      you want detailed information. Alternatively, you can use the -verbose
      option for more detailed information about the rpcprofile object
      itself.

      Privileges Required

      No special privileges are needed to use the rpcprofile help command.

      Examples

      cecp> rpcprofile help
      add		  Adds members to a list of RPC profiles.
      create		  Creates a list of empty RPC profiles.
      delete		  Deletes a list of RPC profiles.
      import		  Returns the bindings from a list of RPC profiles.
      list		  Returns the names of members of a list of RPC profiles.
      remove		  Removes members from a list of RPC profiles.
      show		  Returns the attributes of a list of RPC profiles.
      help		  Prints a summary of command-line options.
      operations	  Returns a list of the valid operations for this command.
      dcecp>


    rpcprofile import
      Returns a string binding from the specified RPC profile. The syntax is
      as follows:

      rpcprofile import profile_name_list -interface interface_id
      [-object object_uuid] [-max integer] [-noupdate]


      Options

      -interface interface_id
		Declares the interface identifier of an RPC interface.	The
		import operation allows you to specify only one
		interface_id, not a list.

		See DATA STRUCTURES for the format of an interface
		identifier.

      -object object_uuid_list
		Declares the UUID of an object.	 Each import operation



 Hewlett-Packard Company	    - 7 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




		accepts a list of up to 32 object UUIDs.  The UUID is a
		hexadecimal string.

      -max integer
		Specifies the maximum number of string bindings to return.
		A value greater than 1 returns a list containing up to the
		number of bindings specified by the value.

      -noupdate Normally, name service data is cached locally on each
		machine in a cell.  If a name service inquiry can be
		satisfied by data in the local CDS cache, this cached data
		is returned.  However, locally cached copies of name service
		data might not include a recent CDS update. If the -noupdate
		option is not specified, dcecp goes to a CDS server to
		retrieve the required data, updating the local CDS cache.
		Use the -noupdate option to avoid taking the time to update
		the local cache when you have reason to believe that the
		local cache is up to date.


      The import operation returns a string binding from the specified RPC
      profile.	The profile_name_list argument is a list of names of RPC
      profiles to import from. Use the -interface and -object options to
      specify matching bindings.  Each of these options takes only one
      value, not a list of values.  The import operation also accepts the
      -max option to specify a number of string bindings to return.  If the
      value is greater than 1, a list of as many matching bindings less than
      or equal to the value is returned.  The order of bindings returned is
      arbitrary.

      Privileges Required

      You need r (read) permission to the specified CDS object entry (the
      starting name service entry) and to any CDS object entry in the
      resulting search path.

      Examples

      The following example imports a binding:

      dcecp> rpcprofile import /.:/cell-profile \
       -interface {458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0}
      ncadg_ip_udp 15.22.48.25}
      {ncadg_ip_udp 15.22.50.213}
      {ncacn_ip_tcp 15.22.48.25}
      {ncacn_ip_tcp 15.22.50.213}
      dcecp>&gt&gt>


    rpcprofile list




 Hewlett-Packard Company	    - 8 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      Returns a list of the names of all members of the specified profile.
      The syntax is as follows:

      rpcprofile list profile_name_list [-member member_name_list]
      [-noupdate]


      Options

      -member member_name_list
		Declares the names of members of the specified profile
		entry.	The member_name_list argument is a list of names of
		one or more members to be listed.

      -noupdate Use this option to avoid taking the time to update the local
		cache. See rpcprofile import for more information.


      The list operation returns a list of the names of all members of the
      specified profile.  The names returned are fully qualified and are
      returned in an arbitrary order.  The profile_name_list argument is a
      list of names of RPC profiles whose members' names are to be returned.
      The members are concatenated on output into one list.

      Privileges Required

      You need r (read) permission to the CDS object entry (the target
      profile entry).

      Examples

      The following command lists entries in the cell profile /.:/cell-
      profile in the local cell:

      dcecp>&gt&gt> rpcprofile list /.:/cell-profile
      /.../my_cell.goodcompany.com/sec
      /.../my_cell.goodcompany.com/sec-v1
      /.../my_cell.goodcompany.com/sec
      /.../my_cell.goodcompany.com/sec
      /.../my_cell.goodcompany.com/lan-profile
      /.../my_cell.goodcompany.com/fs
      /.../my_cell.goodcompany.com/subsys/dce/dfs/bak
      dcecp>&gt&gt>


    rpcprofile operations
      Returns a list of the operations supported by the rpcprofile object.
      The syntax is as follows:

      rpcprofile operations




 Hewlett-Packard Company	    - 9 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      The list of available operations is in alphabetical order except for
      help and operations, which are listed last.

      Privileges Required

      No special privileges are needed to use the rpcprofile operations
      command.

      Examples

      dcecp> rpcprofile operations
      add create delete import list remove show help operations
      dcecp>


    rpcprofile remove
      Removes one or more members from the specified profile.  The syntax is
      as follows:

      rpcprofile remove profile_name_list
      {-default | -member member_name -interface interface_id |
      -annotation annotation | -priority priority}


      Options

      -default	Performs the remove operation on the default profile
		element.  When you use the -default option, all of the other
		options are illegal.

      -member member_name
		Lets you specify the name a member to be removed from all
		profiles named in the profile_name_list argument.  The value
		of the -member option is a single name of an RPC entry, RPC
		group, or RPC profile; the name is only a reference stored
		in the RPC profile and need not exist outside of the
		profile. The specified member is removed from all RPC
		profiles specified in the argument.

      -interface interface_id
		Declares the interface identifier of an RPC interface.	The
		remove operation allows you to specify only one
		interface_id.

		See DATA STRUCTURES for the format of an interface
		identifier.

      -annotation annotation
		Defines an annotation string for the profile element to be
		removed. You can include internal spaces in an annotation by
		enclosing the string in quotation marks (or by using other



 Hewlett-Packard Company	   - 10 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




		dcecp quoting mechanisms).

      -priority priority
		Defines a search priority for the profile element you want
		to see.	 The priority value is in the range 0 to 7, with 0
		having the highest priority.  By default, a nondefault
		element is assigned a priority value of 0.


      The remove operation removes one member from the specified profiles.
      The profile_name_list argument is a list of names of RPC profiles from
      which the member is to be removed.  The member to be removed must
      match the values given in the following options: -member, -interface,
      and -annotation. These options are all single-valued; they are not
      lists.  The matching member is removed from all RPC profiles specified
      in the argument.	 Also accepts a -default option, in which case the
      above options are illegal and the default profile member is removed.
      This operation returns an empty string on success.  If the specified
      member does not exist in an RPC profile, an error is returned.

      Privileges Required

      You need r (read) and w (write) permission to the CDS object entry
      (the target profile entry).

      Examples

      The following example removes the member
      /.:/subsys/applications/infobases with interface {baf8c319-998f-11cd-
      ac7b-0000c08adf56 1.0} from the specified RPC profile entry:

      dcecp>&gt&gt> rpcprofile remove /.:/users/admin_profile \
      >&gt&gt> -member /.:/subsys/applications/infobases \
      >&gt&gt> -interface {baf8c319-998f-11cd-ac7b-0000c08adf56 1.0}
      dcecp>&gt&gt>


    rpcprofile show
      Returns a list of all members of one or more profiles. The syntax is
      as follows:

      rpcprofile show profile_name_list
      {-default | [-member member_name] [-interface interface_id]
      [-version versions] [-priority priority] [-annotation annotation]
      [-noupdate]}


      Options

      -default	Performs the show operation on the default profile element.
		When you use the -default option, all of the other options



 Hewlett-Packard Company	   - 11 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




		are illegal.

      -member member_name
		Specifies one member name for which to return profile
		information.

      -interface interface_id
		Declares the interface identifier of an RPC interface.	The
		show operation allows you to specify only one interface_id.

		See DATA STRUCTURES for the format of an interface
		identifier.

      -version versions
		Specifies interface version numbers to be returned.

		See DATA STRUCTURES for the exact behavior of the version
		values.

      -priority priority
		Defines a search priority for the profile element you want
		to see.	 The priority value is in the range 0 to 7, with 0
		having the highest priority.  By default, a nondefault
		element is assigned a priority value of 0.

      -annotation annotation
		Defines an annotation string for the profile element.  You
		can include internal spaces in an annotation by enclosing
		the string in quotation marks (or by using other dcecp
		quoting mechanisms).

      -noupdate Use this option to avoid taking the time to update the local
		cache. See rpcprofile import for more information.


      The show operation returns a list of all members of one or more
      profiles.	 The profile_name_list argument is a list of names of RPC
      profiles from which to have members returned.  An attribute list is
      returned for each member with all of the entered information. The list
      is in the following order: interface, member, priority, annotation.
      If any of the items is not given, they are not included in the output,
      that is, no place holder is included.

      Only those members that match the values specified by the given
      options are returned. Each option may have only one value (that is,
      the value may not be a list).  Also accepts a -default option, in
      which case the above options are illegal and the default profile
      member is returned.

      Privileges Required




 Hewlett-Packard Company	   - 12 -	      OSF DCE 1.1/HP DCE 1.8






 rpcprofile(1m)		  Open Software Foundation	      rpcprofile(1m)




      You need r (read) permission to the CDS object entry (the target
      profile entry).

      Examples

      The following example uses no options to show all the members of a
      profile:

      dcecp> rpcprofile show /.:/users/temp_profile
      {{458ffcbe-98c1-11cd-bd93-0000c08adf56 1.0} /.../cell.co.com/subsys/appls/infobases 0}
      {{00000000-0000-0000-0000-000000000000 0.0} /.../cell.co.com/cell-profile 0}
      {{baf8c319-998f-11cd-ac7b-0000c08adf56 1.0} /.../cell.co.com/subsys/appls/infobases 0}
      dcecp>


      The following example uses the -interface option to show a single
      member of a profile.

      dcecp>&gt&gt> rpcprofile show /.:/users/temp_profile \
      >&gt&gt> -interface {baf8c319-998f-11cd-ac7b-0000c08adf56 1.0}
      {{baf8c319-998f-11cd-ac7b-0000c08adf56 1.0} /.../cell.co.com/subsys/appls/infobases 0}


 RELATED INFORMATION
      Commands: dcecp(1m), dcecp_endpoint(1m), dcecp_rpcentry(1m),
      dcecp_rpcgroup(1m).




























 Hewlett-Packard Company	   - 13 -	      OSF DCE 1.1/HP DCE 1.8