pubsub(1) [mojave man page]
pubsub(1) BSD General Commands Manual pubsub(1) NAME
pubsub -- Utility for managing RSS/Atom subscriptions via the PubSub framework SYNOPSIS
pubsub [--client bundleID] subcommand [parameters] OPTIONS
The available options are as follows: --client Force tool to act as one specific client ENVIRONMENT
The pubsub tool is a command-line utility for interacting with the PubSub framework. It is intended for troubleshooting, as a simple way to see at a glance all the feed subscriptions that the agent will be periodically fetching, and to delete any left-over subscriptions (for exam- ple, of an application that's been deleted.) If the --client flag is given, the tool will act only on the PubSub client with the given bundle ID. For example, pubsub list will list only the feeds that client is subscribed to. Some subcommands, such as subscribe, require a client to be specified. The following subcommands are supported. Note that some have multi-word names. If no subcommand is given, a short listing of their names will be output. list Lists all feeds (of all clients, or of the specific client if the -client flag is given.) The title, URL and refresh interval of each feed are shown. Note that a feed subscribed by multiple clients will be listed once per client, and that each client may specify a different refresh interval. However, the PubSub agent will only fetch one copy of the feed, at the minimum interval. The interval is listed in parentheses if it is inherited from the client's default refresh interval. The interval is followed by a " * " if the feed will be refreshed even when the client application is not currently running. The interval is followed by a " * " if file enclosures will automatically be downloaded. list clients Lists all registered clients by bundle ID, along with their number of subscriptions. list client bundleID Lists only the feeds subscribed to by the given client. unsubscribe URL Unsubscribes from the feed with the given URL. subscribe URL Subscribes the client (which must be specified using --client ) to the given feed. list URL Lists all entries currently stored for the given feed. dump URL Prints the raw XML of the feed, as it was last fetched from the network. list entry identifier Lists the attributes of an individual entry, given its identifier (a 40-char hex string). dump entry identifier Prints the XML of an entry, given its identifier (a 40-char hex string). refresh URL Fetches the feed from the network immediately, and updates the database if it has changed. listen [timestamp] Installs a PSClient delegate and listens for changes to subscribed feeds and entries, printing messages when they occur. If a time- stamp is given, all changes that have occurred since that time will first be printed. The timestamp is given as a number of seconds since the system "reference date", i.e. the same as the result of -[NSDate timeIntervalSinceReferenceDate]. list downloads Lists all enclosures currently being downloaded. list enclosures Lists all enclosures, and their current download status. FILES
~/Library/PubSub/ Per-user PubSub configuration/data directory EXAMPLES
pubsub list pubsub --client com.example.SurfNews subscribe http://example.com/UninterestingFeed.xml pubsub unsubscribe http://example.com/UninterestingFeed.xml Mac OS X 10.5 February 1, 2007 Mac OS X 10.5
Check Out this Related Man Page
XML::Atom::Feed(3pm) User Contributed Perl Documentation XML::Atom::Feed(3pm) NAME
XML::Atom::Feed - Atom feed SYNOPSIS
use XML::Atom::Feed; use XML::Atom::Entry; my $feed = XML::Atom::Feed->new; $feed->title('My Weblog'); $feed->id('tag:example.com,2006:feed-id'); my $entry = XML::Atom::Entry->new; $entry->title('First Post'); $entry->id('tag:example.com,2006:entry-id'); $entry->content('Post Body'); $feed->add_entry($entry); $feed->add_entry($entry, { mode => 'insert' }); my @entries = $feed->entries; my $xml = $feed->as_xml; ## Get a list of the <link rel="..." /> tags in the feed. my $links = $feed->link; ## Find all of the Atom feeds on a given page, using auto-discovery. my @uris = XML::Atom::Feed->find_feeds('http://www.example.com/'); ## Use auto-discovery to load the first Atom feed on a given page. my $feed = XML::Atom::Feed->new(URI->new('http://www.example.com/')); USAGE
XML::Atom::Feed->new([ $stream ]) Creates a new feed object, and if $stream is supplied, fills it with the data specified by $stream. Automatically handles autodiscovery if $stream is a URI (see below). Returns the new XML::Atom::Feed object. On failure, returns "undef". $stream can be any one of the following: o Reference to a scalar This is treated as the XML body of the feed. o Scalar This is treated as the name of a file containing the feed XML. o Filehandle This is treated as an open filehandle from which the feed XML can be read. o URI object This is treated as a URI, and the feed XML will be retrieved from the URI. If the content type returned from fetching the content at URI is text/html, this method will automatically try to perform auto- discovery by looking for a <link> tag describing the feed URL. If such a URL is found, the feed XML will be automatically retrieved. If the URI is already of a feed, no auto-discovery is necessary, and the feed XML will be retrieved and parsed as normal. XML::Atom::Feed->find_feeds($uri) Given a URI $uri, use auto-discovery to find all of the Atom feeds linked from that page (using <link> tags). Returns a list of feed URIs. $feed->link If called in scalar context, returns an XML::Atom::Link object corresponding to the first <link> tag found in the feed. If called in list context, returns a list of XML::Atom::Link objects corresponding to all of the <link> tags found in the feed. $feed->add_link($link) Adds the link $link, which must be an XML::Atom::Link object, to the feed as a new <link> tag. For example: my $link = XML::Atom::Link->new; $link->type('text/html'); $link->rel('alternate'); $link->href('http://www.example.com/'); $feed->add_link($link); $feed->add_entry($entry) Adds the entry $entry, which must be an XML::Atom::Entry object, to the feed. If you want to add an entry before existent entries, you can pass optional hash reference containing "mode" value set to "insert". $feed->add_entry($entry, { mode => 'insert' }); $feed->entries Returns list of XML::Atom::Entry objects contained in the feed. $feed->language Returns the language of the feed, from xml:lang. $feed->author([ $author ]) Returns an XML::Atom::Person object representing the author of the entry, or "undef" if there is no author information present. If $author is supplied, it should be an XML::Atom::Person object representing the author. For example: my $author = XML::Atom::Person->new; $author->name('Foo Bar'); $author->email('foo@bar.com'); $feed->author($author); $feed->id([ $id ]) Returns an id for the feed. If $id is supplied, set the id. When generating the new feed, it is your responsibility to generate unique ID for the feed and set to XML::Atom::Feed object. You can use http permalink, tag URI scheme or urn:uuid for handy. UNICODE FLAGS
By default, XML::Atom takes off all the Unicode flag fro mthe feed content. For example, my $title = $feed->title; the variable $title contains UTF-8 bytes without Unicode flag set, even if the feed title contains some multibyte chracters. If you don't like this behaviour and wants to andle everything as Unicode characters (rather than UTF-8 bytes), set $XML::Atom::ForceUnicode flag to 1. $XML::Atom::ForceUnicode = 1; then all the data returned from XML::Atom::Feed object and XML::Atom::Entry object etc., will have Unicode flag set. The only exception will be "$entry->content->body", if content type is not text/* (e.g. image/gif). In that case, the content body is still binary data, without Unicode flag set. CREATING ATOM 1.0 FEEDS By default, XML::Atom::Feed and other classes (Entry, Link and Content) will create entities using Atom 0.3 namespaces. In order to create 1.0 feed and entry elements, you can set Version as a parameter, like: $feed = XML::Atom::Feed->new(Version => 1.0); $entry = XML::Atom::Entry->new(Version => 1.0); Setting those Version to every element would be sometimes painful. In that case, you can override the default version number by setting $XML::Atom::DefaultVersion global variable to "1.0". use XML::Atom; $XML::Atom::DefaultVersion = "1.0"; my $feed = XML::Atom::Feed->new; $feed->title("blah"); my $entry = XML::Atom::Entry->new; $feed->add_entry($entry); $feed->version; # 1.0 AUTHOR &; COPYRIGHT Please see the XML::Atom manpage for author, copyright, and license information. perl v5.12.4 2009-04-24 XML::Atom::Feed(3pm)