net/packet: add PACKET_<ADD|DROP>_MEMBERSHIP support

[zhhyu7]

Summary

Some third-party network libraries use PACKET_ADD_MEMBERSHIP to add MAC addresses to devices, and this patch can add support for this.

Impact

net/pkt: setsockopt

Testing

sim:matter with below test code:

#include <nuttx/config.h>
#include <net/if.h>
#include <netinet/if_ether.h>
#include <netpacket/packet.h>
#include <string.h>
#include <stdio.h>

int main(int argc, FAR char *argv[])
{
    int fd;
    int res;
    struct packet_mreq mreq;
    char macaddr[ETH_ALEN] = {0x91, 0xe0, 0xf0, 0x00, 0x0e, 0x01};

    fd = socket(AF_PACKET, SOCK_RAW, htons(ETH_P_ALL));
    if (fd < 0) {
        perror("Failed to open socket");
        return -1;
    }
    mreq.mr_ifindex = 1; // eth0
    mreq.mr_type = PACKET_MR_MULTICAST;
    mreq.mr_alen = ETH_ALEN;
    memcpy(&mreq.mr_address, macaddr, ETH_ALEN);

    res = setsockopt(fd, SOL_PACKET, PACKET_ADD_MEMBERSHIP,
                    &mreq, sizeof(struct packet_mreq));
    if (res < 0) {
        perror("Couldn't set PACKET_ADD_MEMBERSHIP");
    } else {
        printf("Successfully set PACKET_ADD_MEMBERSHIP\n");
    }

    close(fd);
    return res;
}

NuttX test log

NuttShell (NSH) NuttX-12.11.0
MOTD: username=admin password=Administrator
nsh> ifconfig
eth0	Link encap:Ethernet HWaddr 42:e1:c4:3f:48:dd at RUNNING mtu 1500
	inet addr:10.0.1.2 DRaddr:10.0.0.1 Mask:255.255.255.0
	inet6 addr: fe80::40e1:c4ff:fe3f:48dd/64
	inet6 DRaddr: ::

nsh> hello
Successfully set PACKET_ADD_MEMBERSHIP
nsh> 

[acassis]

@zhhyu7 please add a Documentation about it at https://nuttx.apache.org/docs/latest/components/net/index.html maybe more specifically here: https://nuttx.apache.org/docs/latest/components/net/netdriver.html or create a new entry to it if you think it doesn't fit in the existing categories.

[zhhyu7]

@zhhyu7 please add a Documentation about it at https://nuttx.apache.org/docs/latest/components/net/index.html maybe more specifically here: https://nuttx.apache.org/docs/latest/components/net/netdriver.html or create a new entry to it if you think it doesn't fit in the existing categories.

OK, After https://github.com/apache/nuttx/pull/17483 PR is merged, I will add the new part based on the modifications of this PR.

[xiaoxiang781216]

@zhhyu7 please add a Documentation about it at https://nuttx.apache.org/docs/latest/components/net/index.html maybe more specifically here: https://nuttx.apache.org/docs/latest/components/net/netdriver.html or create a new entry to it if you think it doesn't fit in the existing categories.

OK, After https://github.com/apache/nuttx/pull/17483 PR is merged, I will add the new part based on the modifications of this PR.

@acassis let's finish the document on the next patch?

[acassis]

@zhhyu7 please add a Documentation about it at https://nuttx.apache.org/docs/latest/components/net/index.html maybe more specifically here: https://nuttx.apache.org/docs/latest/components/net/netdriver.html or create a new entry to it if you think it doesn't fit in the existing categories.

OK, After https://github.com/apache/nuttx/pull/17483 PR is merged, I will add the new part based on the modifications of this PR.

@acassis let's finish the document on the next patch?

@xiaoxiang781216 from previous experience the Documentation never come later, if the PR adds a new feature, it needs to include a Documentation. We all agreed on that in the voting. Similar for testing, to avoid breaking the mainline with features that people forget to test

[acassis]

@zhhyu7 please add Documentation

[zhhyu7]

@zhhyu7 please add Documentation

@acassis I added sample code and updated the relevant description information, please review again, thanks.

documentation is provided.