Menu Close

Go – RegisterName Function in net/rpc package in Go

In this article, we will explore the RegisterName Function in net/rpc package in Go in detail, along with examples.


Go, also known as Golang, is a versatile programming language designed for building concurrent and networked applications. One of the standard libraries provided by Go is the ‘net/rpc’ package, which enables developers to create and use Remote Procedure Calls (RPC) for communication between various application components. In this article, we will explore the RegisterName function, an essential feature of the ‘net/rpc’ package, and discuss its purpose, usage, and a practical example to better understand its functionality.

What is RegisterName Function ?

The RegisterName function is part of the ‘net/rpc’ package in Go, which primarily focuses on creating RPC clients and servers. This function is similar to the Register function, as it is used to register a service object representing the methods that the server can call remotely. However, the RegisterName function allows you to specify a custom name for the service instead of using the default type name of the service object.

Function Signature

The function signature for RegisterName is as follows:

func RegisterName(name string, rcvr interface{}) error

The RegisterName function takes two arguments: a string representing the custom name for the service, and an ‘interface{}’ type representing the service object to be registered. If the registration is successful, the function returns nil; otherwise, it returns an error containing information about the issue.


Let’s take a look at an example to understand how the RegisterName function works in conjunction with the ‘net/rpc’ package:

package main

import (

type Greeter struct{}

func (g *Greeter) Greet(name *string, reply *string) error {

	*reply = fmt.Sprintf("Hello, %s!", *name)

	return nil

func main() {

	addr := "localhost:12345"

	greeter := new(Greeter)

	err := rpc.RegisterName("CustomGreeter", greeter)

	if err != nil {
		fmt.Println("Error registering CustomGreeter:", err)

	listener, err := net.Listen("tcp", addr)

	if err != nil {
		fmt.Println("Error listening:", err)
	defer listener.Close()

	fmt.Printf("RPC server listening on %s\n", addr)


In this example, we create a simple RPC server that responds to Greet function calls. We define a ‘Greeter’ type and a ‘Greet’ method for that type. The ‘Greet’ method takes a name as input and returns a greeting message.

We then create an instance of ‘Greeter’ and register it with the ‘net/rpc’ package using ‘rpc.RegisterName()’, providing a custom name, “CustomGreeter”. After successful registration, we create a listener using ‘net.Listen()’ on ‘localhost:12345’ and call the ‘Accept()’ function on the ‘rpc’ default server instance to serve incoming RPC requests.

Note that this example demonstrates the server-side implementation of the RPC system. To fully test the functionality, you would need to create a separate client-side implementation to connect to this server and call the ‘Greet’ method, referencing the “CustomGreeter” service name.


The RegisterName function in Go’s ‘net/rpc’ package is a valuable tool for building RPC servers with custom service names. By registering service objects and their methods with the RPC system using a specified name, it allows for more flexible communication between different application components. The example above demonstrates the simplicity of using the RegisterName function along with the ‘net/rpc’ package to create an RPC server.

To check more Go related articles. Pls click given below link:

Posted in golang, net, packages

Leave a Reply

Your email address will not be published. Required fields are marked *